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PREFACE 


System/360 Operating System utility 
programs provide functions to assist pro¬ 
grammers responsible for creating and main¬ 
taining operating system data. These func¬ 
tions are requested through simple control 
statements, which can be used individually 
or in combination, to perform a variety of 
housekeeping and support operations. 

This publication discusses the functions 
provided by each utility program and the 
control statements used to request these 
functions. Appendixes A and B contain 
information for linking to exit routines 
and invoking utility programs. Appendixes 
C, D, and E contain the error messages and 
return codes issued by the utility pro¬ 
grams . 

The reader should be familiar with the 
concepts and terminology introduced in the 
prerequisite publications. 
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INTRODUCTION 


The IBM System/360 Operating System pro¬ 
vides utility programs to assist in organ¬ 
izing and maintaining data. There are 
three types of programs: system utilities,, 
data set utilities, and independent utili¬ 
ties. 


System utility programs, executed under 
the operating system: 

• Modify system control data by building 
and maintaining catalogs and volume 
structures. 

• Move and copy collections of data in 
order to rearrange data and create 
backup copies. 

• List a catalog, a directory of a parti¬ 
tioned data set, and a volume table of 
contents. 

Data set utility programs, also executed 
under the operating system: 

• Copy and merge partitioned data set 
members. 

• Copy records from sequential data sets 
and convert sequential data sets to 
partitioned organization. 

• Compare records in sequential or parti¬ 
tioned data sets. 


• Print or punch records in sequential or 
partitioned data sets. 

• Update symbolic library modules at the 
source language level. 


Independent utility programs, executed 
outside of the System/360 Operating System: 

• Initialize and assign alternate tracks 
to direct-access volumes. 


• Dump and restore the data contents of a 
direct-access volume. 


Format of Utility Control Statements 


The control statements for the 
System/360 operating system utility pro¬ 
grams have the following standard format: 


r 

(Name 

i 

"T ' 

|Operation 

T ~ ^ " 

|Operand 

i 

i 

_j 

r 

| Optional 

j Control 

T 

|Optional and 

I 

i 

| symbolic 

j statement 

j required 

i 

j name 

jtype 

j parameters 

X 

i 

_j 


The name symbolically identifies the 
control statement and can be omitted at the 
discretion of the utility user. When 
included, a name must begin in the first 
position of the statement and must be 
followed by one or more blanks. It can 
contain from one to eight alphameric char¬ 
acters,, the first of which must be alpha¬ 
betic. 

The operation identifies the type of 
control statement. It must be preceded and 
followed by one or more blanks. 

The operand is made up of one or more 
keyword parameters separated by commas. 
The operand field is ended with a blank. 
Commas, parentheses, and blanks can only be 
used as delimiting characters. 

Comments can be written in a utility 
statement, but they must be separated from 
the last parameter of the operand field by 
one or more blanks. 

A typical utility statement might appear 

as : 

|NAME OPERATION KEYWORD=information,... ] 

I______j 

Utility statements are coded on cards or 
as card images and are contained in columns 
1 through 71. A statement that exceeds 71 
characters can be continued onto one or 
more additional cards; a nonblank character 
is placed in column 72 to indicate continu¬ 
ation. The statement can be interrupted 
either in column 71 or after any comma. 
The continued portion of the statement must 
begin in column 16 of the following card. 
Comments are continued in column 17 of the 
following card, or can appear on every card 
of a continued statement. 
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Notation for Defining Control Statements 


The notation used to define control 
statements in this publication is described 
in the following paragraphs. 


1. The set of symbols listed below are 
used to define control statements,, but 
are never written in an actual state¬ 
ment. 

hyphen - 

underscore 

braces {} 

brackets [] 

ellipsis ... 

The special uses of these symbols are 
explained in paragraphs 5-9. 


Example: If member-name appears in a 
statement definition, a specific value 
(e.g., BETA) is substituted for the 
variable in the actual statement. 


6 . An underscore indicates a default 
option. If an underscored alternative 
is selected, it need not be written in 
the actual statement. 


Example: The representation 



indicates that either A or B or C 
should be selected; however, if B is 
selected, it need not be written, 
because it is the default option. 


2. Upper-case letters and words, numbers, 
and the set of symbols listed below 
are written in an actual control 
statement exactly as shown in the 
statement definition. 

apostrophe ' 

asterisk * 

comma , 

equal sign = 

parentheses () 

period 


3. Lower-case letters, words,, and symbols 
appearing in a control statement defi¬ 
nition represent variables for which 
specific information is substituted in 
the actual statement. 

Example: If name appears in a state¬ 
ment definition, a specific value 
(e.g., ALPHA) is substituted for the 
variable in the actual statement. 


4. Stacked items represent alternatives. 
Only one such alternative should be 
selected. 

Example: The representation 

A 

B 

C 

indicates that either A or B or C 
should be selected. 


5. Hyphens join lower-case letters, 
words, and symbols to form a single 
variable. 


7. Braces group related items, such as 
alternatives. 

Example: The representation 
ALPHA= (| B |„ D) 

indicates that a choice should be made 
among the items enclosed within the 
braces. If A is selected, the result 
is ALPHA=(A,D). If C is selected, the 
result can be either ALPHA=(,D) or 
ALPHA=(C,D) . 


8 . Brackets also group related items; 
however,, everything within the brack¬ 
ets is optional and may be omitted. 


Example: The representation 


ALPHA= ( 


A' 

B 

C 


,D) 


indicates that a choice can be made 
among the items enclosed within the 
brackets or that the items within the 
brackets can be omitted. If B is 
selected, the result is: ALPHA=(B,D)• 
If no choice is made, the result is: 
ALPHA=(,D). 


9. An ellipsis indicates that the preced¬ 
ing item or group of items can be 
repeated more than once in succession. 


Example: ALPHA(,BETA]... indicates 
that ALPHA can appear alone or can be 
followed by ,BETA any number of times 
in succession. 
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SECTION 1 : 


SYSTEM UTILITIES 


System utility programs manipulate col¬ 
lections of data and system control infor¬ 
mation- They include: 

• IEHPROGM — a program that builds and 
maintains system control data. 

• IEHMOVE — a program that moves and 
copies collections of data. 

• IEHLIST — a program that lists system 
control data. 


This section describes the capabilities, 
requirements for execution# and examples of 
the use of each system utility program. 


Job Control Statement Requirements 

System utility programs can be intro¬ 
duced as jobs or job steps# and are execut¬ 
ed in response to job control statements 
and utility control statements. The job 
control statements used are: 

• A JOB statement. 

• An EXEC statement that identifies the 
system utility program to be executed. 

• A DD statement named SYSPRINT that 
defines an output data set used by the 
utility program. 

• A group of DD statements that allocate 
the devices required by the utility 
program. 

• A DD statement named SYSIN that defines 
a sequential data set used for utility 
statement input. 

Figure 1 illustrates a set of job control 
statements used to execute a system utility 
program. 

System utility programs can also be 
employed as subroutines by use of the 
System/360 Operating System linkage conven¬ 
tions. At the completion or termination of 
the utility program* the highest return 
code encountered within the program is 
passed to the calling program. Invocation 
of utility programs and linkage conventions 
are discussed in Appendix B,. 


Cataloging Procedures 


Execution of a system utility program 
can be simplified by cataloging a set of 
job control statements for each program. 
The result is a cataloged procedure. The 
DD statements in a procedure should ensure 
that a sufficient number of devices are 
allocated for most applications of the 
program. The cataloged DD statements can 
be overridden or modified for applications 
that require more devices. 

A set of control statements might 
include: 

• An EXEC statement that identifies the 
utility program to be executed. 

• A DD statement named SYSPRINT that 
defines a sequential data set used for 
message output. 

• One DD statement for each permanently 
mounted volume. (The system residence 
volume is considered to be permanent.) 

• One DD statement for each type of 
mountable device. 

• One DD statement for each additional 
mountable device required by the pro¬ 
gram. 

Note: DD statements defining permanently 

mounted devices must specify DISP=(OLD,...) 
to prevent deletion of the data set. DD 
statements defining mountable devices must 
specify UNIT= (...# DEFER) ,# DISP= (NEW# KEEP) # 
and VOLUME=(PRIVATE#. . .). 


Executing Cataloged Procedures 


The job control statements required to 
execute a cataloged procedure are: 

• A JOB statement. 

• An EXEC statement that specifies 
PROC=procname# where procname is the 
name of the cataloged procedure. 

• A group of DD statements that define 
the additional device requirements of a 
particular job# or that modify cata¬ 
loged DD statements. 


Section 1: System Utilities 
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Figure 1. Executing a System Utility Program 


Figure 2 illustrates job control statements • A single device, 

and utility statements used together to • All devices of a specific type. 

execute a cataloged procedure. 

Device names that represent two or more 
different device types cannot be used. 


Identifying Volumes and Data Sets 


The term "serial" is replaced by a 1- to 
6 -character volume serial number. 


A utility statement identifies the par- The term "seqno" is replaced by a data 

ticular function to be performed and, when set sequence number. When a device other 

required, the specific volumes or data sets than tape is specified, the sequence number 

to be used- Volumes are identified by is omitted, as follows: 
device type and volume serial number. 

A data set residing on a direct-access 
volume is identified by the volume serial 
number and its data set name; a data set 
residing on a tape volume must be further 
identified by its data set sequence number. 

In general, identification parameters are 
coded as follows: 

r-1 

|KEYWORD=devie 2 =(serial,seqno,...) | |KEYWORD=device=serial | 

l_ j i-J 

Applicable keywords include VOL, CVOL, Hereafter, a volume parameter that may 

FROM, and TO. require more than one volume will be 


referred to as: 

The term "device" is replaced by any of 

a group of device names that the installa- r - 

tion defines when the operating system is |KEYWORD=device=list 

generated. Each device name may represent: 1 -J 


r- n 

| KEYWORD=device= (serial,,serial,,.. . ) 

i-j 

If only a single direct-access device is 
required, the parentheses can be deleted, 
as follows: 



Figure 2. Executing a Cataloged Utility Procedure 
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MODIFYING SYSTEM CONTROL DATA 


The IEHPROGM utility program provides efficient facilities for modifying system 
control data. It can be used to scratch, rename, catalog, and uncatalog data sets; to 
build and delete indexes or index aliases; to connect and release control volumes; and to 
build generation indexes. This program is executed or invoked with the symbolic name 
IEHPROGM. 


Scratching a Data Set 

The SCRATCH statement is used to scratch 
a data set or member from a direct-access 
volume. A data set is considered scratched 
when its data set label is removed from the 
volume table of contents of the volume on 
which it resides, and its space is made 
available for reallocation. A member is 
considered scratched when its name is 
removed from the directory of the parti¬ 
tioned data set in which it is contained. 
A data set or member is scratched only from 
the volumes designated in the SCRATCH 
statement. This function does not uncata¬ 
log scratched data sets. 

Note: If the device operates in split- 
cylinder mode, the tracks occupied by a 
scratched data set will not be available 
for reallocation until all data sets 
sharing the cylinder have been scratched. 

Note: A password-protected data set being 
scratched is over-written to prevent 
retrieval of its contents. 


r- t-t-1 

|Name |Operation|Operand | 

h-+-+--7-H 


j[name]jSCRATCH | DSNAME=namel | 

j IVTOC 1 j 

| j jVOL=device=list 

| j j [PURGE] I 

I[MEMBER=name] j 

| I I[SYS] | 

L_I-1-J 

D SNAME=name 

specifies the fully qualified name of 
either the data set to be scratched, 
or the partitioned data set that con¬ 
tains the member to be scratched. 

VTOC 

specifies that all data sets on the 
specified volume, except those pro¬ 
tected by a password, are to be 
scratched. Password-protected data 
sets are scratched if the correct 
password is provided. 

VOL=device=list 

specifies the volume or volumes that 
contain the data set or data sets to 
be scratched. If VTOC is specified, 
VOL should not specify a system resi¬ 
dence volume. 

PURGE 

requests that each data set specified 
by DSNAME or VTOC be scratched, even 


if its expiration date has not 
elapsed. 

If PURGE is omitted, the specified 
data sets are scratched only if their 
expiration dates have elapsed. 

MEMBER=name 

specifies the name of a member to be 
scratched from the named data set. 

If omitted, the entire data set or 
volume of data sets is scratched. 

SYS (used only with SCRATCH VTOC 
operations) 

requests that data sets whose names 
begin with AAAAAAAA. AAAAAAAA.AAAAAAAA. 
AAAAAAAA be scratched. (These are 
names assigned to data sets by the 
operating system.) 


Renaming a Data Set (RENAME) 

The RENAME statement is used to change 
the name of a data set or membei that 
resides on a direct-access volume. The 
data set or member is renamed only on the 
designated volumes. This function does not 
update the catalog after the operation. 


|Name |Operation|Operand 

^ - + - -+ - ^ 

|[name]j RENAME j DS NAME= name | 

j j j VOL=device=list | 

j j |NEWNAME=name 

| |[MEMBER= name] | 

L_X_J__J 

DSNAME=name 


specifies the fully qualified name of 
the data set to be renamed, or the 
data set that contains the member to 
be renamed. 

VOL=device=list 

specifies the volume or volumes that 
contain the data set to be renamed. 
NEWNAME=name 

specifies the new fully qualified name 
for the' data set, or the new member 
name. 

MEMBER=name 

specifies the name of a member (in the 
named data set) that is to be renamed. 

If omitted, the entire data set is 
renamed. 


The IEHPROGM Program 
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Cataloging a Data Set (CATLG) 


The CATLG statement is used to generate 
an entry in an index of the catalog. The 
entry contains a data set name and asso¬ 
ciated volume information. If higher level 
indexes are required, the CATLG function 
automatically creates them. 


Building an Index (BLDX) 


The BLDX statement is used to create a 
new index in the catalog. If the creation 
of an index requires that higher level 
indexes be created, the BLDX function auto¬ 
matically creates them. 



r- t-t-1 

| Name |Operation|Operand | 


j[name]jCATLG |DSNAME=name 
| j jVOL=device=list 

| j j [CVOL=device=serial] j 

l -x-x-J 


DSNAME=name 

specifies the fully qualified name of 
the data set to be cataloged. 

VOL=device=list 

specifies the volume or volumes that 
contain the data set to be cataloged. 

CVOL=device=seria1 

specifies the device type and volume 
serial number of the control volume at 
which the catalog search for the index 
is to begin. 

If CVOL is omitted, the system resi¬ 
dence volume is assumed. 


r-T- t - 1 

| Name |Operation)Operand | 

j.-+-1-,| 

j[name]|BLDX |INDEX=name 

|[CVOL=device=serial] 

L_X_L_J 


INDEX=name 

specifies the qualified name of the 
index to be created. 


CVOL=device=serial 

specifies the device type and volume 
serial number of the control volume at 
which the catalog search for the index 
is to begin. 


If CVOL is omitted,, the system resi¬ 
dence volume is assumed. 
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Uncataloging a Data Set (UNCATLG) 


The UNCATLG statement is used to remove 
an entry from an index of the catalog. 


Deleting an Index (DLTX) 


The DLTX statement is used to remove an 
index from the catalog. Only an index that 
has no entries can be removed. 


r- t-t- 

|Name |Operation|Operand 

j.-1-1- 

j [name]j UNCATLG j DSNAME=name 
| j j[CVOL=device=serial] 

l -x-J- 



r- t -r- 1 

| Name | Operation! Operand 


j[name]j DLTX jINDEX=narae 

j j [CVOL=device=serial] 

I_X-L-J 


DSNAME=name 

specifies the fully qualified name of 
the data set to be uncataloged. 

CVOL=device=seria1 

specifies the device type and volume 
serial number of the control volume at 
which the search for the catalog entry 
is to begin. 

If CVOL is omitted, the system resi¬ 
dence volume is assumed. 


INDEX=name 

specifies the qualified name of the 
index to be deleted- 

CVOL=device=serial 

specifies the device type and volume 
serial number of the control volume at 
which the catalog search for the index 
is to begin. 

If CVOL is omitted,, the system resi¬ 
dence volume is assumed. 


* 
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Building an Index Alias (BLDA) 


Connecting Two Control Volumes (CONNECT) 


The BLDA statement is used to assign an 
alternate name to an index at the highest 
level of the catalog* 


The CONNECT statement is used to place 
an entry, containing an index name and a 
volume serial number, into the volume index 
of a control volume* This effectively 
connects two control volumes* 


T - T 

Name |Operation|Operand 

_L 

[name]|BLDA 

T 

|INDEX=name 

i 

jALIAS=name 

i 

|[CVOL=device=serial] 

j. 

X- 


r- t-t-T 

|Name | Operation) Operand | 

f-+-+- 

|[name]jCONNECT |INDEX=name | 

I | jVOL=device=serial | 

j j [CVOL=device=serial] 

I-J.-L-J 


INDEX=name 

specifies the unqualified index name 
to which an alias is to be assigned. 

ALIAS=name 

specifies an unqualified name to be 
assigned as the alias. 


INDEX=name 

specifies the index name to be entered 
in the specified volume index. 

VOL=device=serial 

specifies the device type and volume 
serial number to be entered in the 
specified volume index. 


CVOL=device= seria1 

specifies the device type and volume 
serial number of the control volume 
where the catalog entry is to be made. 


If CVOL is omitted, the system resi¬ 
dence volume is assumed. 


CVOL=device=serial 

specifies the device type and volume 
serial number of the control volume 
into whose volume index the entry is 
to be placed. 

If CVOL is omitted, the system resi¬ 
dence volume is assumed. 


Deleting an Index Alias (DLTA) 


The DLTA statement is used to delete an 
alternate name previously assigned to an 
index at the highest level of the catalog. 


Disconnecting Two Control Volumes (RELEASE) 


The RELEASE statement is used to remove 
an entry from the volume index of a control 
volume. This effectively disconnects two 
control volumes. 


* 


r- t-t- 

|Name |Operation|Operand 

i--+-+- 

|[name]|DLTA |ALIAS=name 

| j |[CVOL=device=serial] 

l _j.-1- 


i 

i 

j 


r- t-t- 

| Name |Operand |Operand 

f- + -+- 

|[name]|RELEASE |INDEX=name 
| j j [CVOL=device=serial] 

L-J.-X- 


I 

I 

I 


i 



ALIAS=name 

specifies the unqualified index alias 
to be deleted. 

CVOL=device=serial 

specifies the device type and volume 
serial number of the control volume 
containing the catalog entry to be 
deleted. 

If CVOL is omitted, the system resi¬ 
dence volume is assumed. 


INDEX=name 

specifies the index name to be removed 
from the specified volume index. 

CVOL=device=serial 

specifies the device type and volume 
serial number of the control volume 
from whose volume index the entry is 
to be removed. 

If CVOL is omitted, the system resi¬ 
dence volume is assumed. 
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Building a Generation Data Group (BLDG) 


The BLDG statement is used to build an 
index for a generation data group and to 
establish the action to be taken when the 
index overflows. In order to build a 
generation data group index, a model data 
set control block (DSCB) must have been 
created on the same control volume. A 
model DSCB is established with a DD state¬ 
ment that requests a space allocation of 
zero tracks. 

If a model DSCB does not exist on this 
control volume, the function is not per¬ 
formed. 

|Name |Operation|Operand | 

t -+-+-i 

| [name]j BLDG |INDEX=name | 

I | j ENTRIES=n j 
| j j[CVOL=device=serial] j 
| | j[EMPTY] j 
| j |[DELETE] j 
L_X-X-J 

INDEX=name 

specifies the name of the generation 
data group index. A DSCB with the 
same name must reside on the same 
control volume. 


ENTRIES=n 

specifies the number of entries to be 
contained in the generation data group 
index; n must not exceed 255. 


CVOL=device=serial 

specifies the device type and volume 
serial of the control volume at which 
the catalog search for the generation 
data group index is to begin. 

If CVOL is omitted,, the system resi¬ 
dence volume is assumed. 

EMPTY 

specifies that all entries be removed 
from the generation data group index 
when it overflows. 

If EMPTY is omitted, the oldest entry 
will be removed when the generation 
data group index overflows. 

DELETE 

specifies that data sets are to be 
scratched after their entries are 
removed from the generation data group 
index. 

If DELETE is omitted,, the data sets 
are not scratched. 


Example 


Figure 3 illustrates some applications of the IEHPROGM utility program. GROUP1 
scratches data set A.B.C and removes its entry from the A.B index,. GROUP2 connects the 
system residence volume with control volume P2„ and builds index X.Y on P2. GROUP3 
changes the data set name R.S.T to C.D.E. GROUP4 builds a new generation data group 
index G.D.G2„ and deletes an existing index G-D.G1 whose entries have been removed with a 
series of UNCATLG operations. 


Sample Coding Form 


J. 

— 

I//JOB1 

JOB 

I// 

EXEC 

I//SYSPRINT DD 

j//DDl 

DD 

j//DD2 

DD 

j//DD 3 

DD 

|//SYSIN 

DD 

j GROUP1 

1 

SCRATCH 

UNCATLG 

|GROUP2 

CONNECT 

1 

BLDX 

|GROUP3 

RENAME 

|GROUP4 

BLDG 

1 

DLTX 

|/* 


Figure 3. 

Modify 


09-550,, BROWN 
PGM=IEHPROGM 
SYSOUT=A 

VOLUME=SER=1234,„ DISP=OLD, UNIT= 23 0 2 

VOLUME=PRIVATE, UNIT= ( 2311* ,,DEFER) „DISP= (NEW, KEEP) 

VOLUME= PRIVATE,UNIT= <2400-2,, „DEFER) ,DISP= (NEW,, KEEP) 
* 

DSNAME=A.B.C,VOL=2311=P3 
DSNAME=A.B.C 
INDEX=X,VOL=2311=P2 
INDEX=X.Y,CVOL= 2 311=P 2 

DSNAME=R.S.T,VOL=2302=D1,NEWNAME=C.D.E 
INDEX=G. D. G2 , ENTRIES= 5,, DELETE 
INDEX=G.D.G1 


Modifying System Control Data 
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MOVING AND COPYING DATA 


The IEHMOVE utility program moves and copies logical collections of IBM System/360 
Operating System data. The program can collect fragments of a data set onto one volume, 
clear an entire volume for reassignment, copy data sets, reorder a collection of data, 
and perform a variety of other housekeeping operations. This program is executed or 
invoked with the symbolic name IEHMOVE. 

A moving operation relocates a collection of data and scratches the source data. A 
copying operation produces a replica of the source collection and leaves the source data 
intact. IEHMOVE can perform move and copy operations on: 

• A data set. 

• A group of data sets. 

• A partitioned data set. 

• A catalog. 

• A volume. 

A partitioned data set can be moved or copied as if it were an ordinary data set, or as a 
partitioned data set to take advantage of a number of additional operations. (See 
Table 1.) Any number of operations can be performed within a given job. If the data is 
movable, space is allocated automatically, if required. If the data is unmovable, space 
must be preallocated. 

Cautions: An unmovable data set can be successfully moved or copied only if space has 
been previously allocated on its receiving volume. (A data set may have been declared 
"immovable" if it contains any location-dependent information. This attribute is 
indicated in the organization section of the data set control block associated with the 
data set.) 

IEHMOVE will attempt to move or copy an unmovable data set, regardless of the reasons 
for which it was declared unmovable. An exception is a BDAM data set which is unmovable 
or one that is movable for which space has been pre-allocated. (See Table 2.) 

System data should be moved with care to ensure its subsequent recovery. 

When moving or copying operations involve a magnetic tape, 9-track tape is assumed to 
have standard labels, and 7-track tape is assumed to have (1) standard labels written in 
low density, even parity, with translate on, and (2) data written in odd parity with 
translate and data conversion off. 

Results of Moving and Copying Operations: A moving or copying operation has one of three 
results: 

• A successful operation. 

• No action. 

• An "unloaded" version of the source data. 

An unloaded version is a sequential data set that contains information for reconstructing 
the source data. It can be used to produce a successful operation by moving or copying 
it onto a volume that would have originally supported a successful operation. 

The above results depend upon the compatibility of the source and receiving volumes 
with respect to size and data set organization, the movability of the source data set, 
and the allocation of space on the receiving volume. (Two volumes are compatible with 
respect to size if the source record size does not exceed the receiving track size.) 
Table 2 indicates the results of moving and copying operations for the various receiving 
volumes and source data sets. The organization of the source data set is noted at the 
top of the table, and the characteristics of the receiving device are listed in the first 
column of the table. 

Additional Job Control Statement Requirements: This program requires a DD statement 
named SYSUT1 that defines a direct-access device, in addition to those DD statements 
described in the section "Job Control Statement Requirements." This statement defines a 
work data set used only with IEHMOVE. 

Utility Statements: Table 1 associates the types of data collections with the MOVE and 
COPY utility statements. The INCLUDE, EXCLUDE, SELECT, and REPLACE utility statements 
can be used to enlarge or restrict the scope of certain MOVE and COPY statements. 


The IEHMOVE Program 
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Table 1. MOVE/COPY Utility Statements 
r - T - 


Data Entity 


Utility Statements 


Additional Statements 


Data Set 2 

i 

i 

i 

i 

I MOVE 
j COPY 

DSNAME 

i 

i 

- + - 

i 

i 

1 

None 

Group of Data Sets 2 

1 MOVE 
{ COPY ] 

DSGROUP 

INCLUDE 

EXCLUDE 

Partitioned Data Set 

i 

i 

j MOVE | 
\ COPY ) 

| PDS 

1 

i 

i 

INCLUDE 

EXCLUDE 


REPLACE 

SELECT 


-+ 


Catalog 


MOVE ( CATALOG 
COPY 


EXCLUDE 


Volume of Data j [ MOVE J 

( COPY J 

_J_ 

^Including partitioned data sets. 


VOLUME 




None 


Table 2. Results of Moving and Copying Operations 
r- 


Receiving Volume 

Non-Direct-Access 

(Mova ble Data) 
(Unmovable Data) 


I- 


Sequential 


Source 

T 


Data Set Organization 
T 


Partitioned 


Direct-Access 


Successful 

Unloaded 


~+ 


Unloaded 

Unloaded 


Unloaded 

Unloaded 


Direct-Access 

(Compatible size) 

• Space allocated by 
utility program 
(Movable Data) 

• Space allocated by 
utility program 
(Unraovable Data) 

• Space previously 
allocated, not used 

• Space previously 
allocated, partially 
used 


Successful 

Unloaded 

Successful 
No action 


Successful 

Unloaded 

Successful 

Successful 

(merge) 


Successful 

Unloaded 1 

Successful 3 - 
No action 




-H 


Direct-Access 

(Incompatible size) 

• Space allocated by 
utility program 

• Space previously 
allocated, not used 

• Space previously 
allocated, partially 
used 

| *For BDAM data sets, no action. 

L- 


Unloaded 
Unloaded 
No action 


Unloaded 
Unloaded 
No action 


Unloaded 
No action 
No action 
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Moving a Data Set (MOVE DSNAME) 


Copying a Data Set (COPY DSNAME) 







The MOVE DSNAME statement is used to 
move a single data set within a volume or 
from one volume to another. If the data 
set is cataloged, the catalog is automat¬ 
ically updated unless UNCATLG is specified. 


The COPY DSNAME statement is used to 
copy a data set onto another volume. The 
source data set, if cataloged, remains 
cataloged unless UNCATLG is specified. The 
copy of the data set will be cataloged on 
its receiving volume if CATLG is specified. 


L_ X 


T 

| Operation 

i 

|Operand 
± , ... .. 

i 

T 

MOVE 

T 

|DSNAME=name 



|TO=device=list 



| rFROM=device=list 

1 


j LCVOL=device=serial. 

J 


j[UNCATLG] 



|[RENAME=namel 


i _ 


J 


r- t-t- 

|Name |Operation!Operand 


COPY 

T ~ 

|DSNAME=name 

- 1 


|TO=device=list 



j ["FROM=device=list "I 



j LCVOL=device=serial J 



1[UNCATLG] 



1 [CATLG] 



j[RENAME=name] 


L 


_J 



% 


% 



DSNAME=name 

specifies the fully qualified name of 
the data set to be moved. 


TO=device=list 

specifies the volume or volumes to 
which the data set is to be moved. 


FROM=device=list 

specifies the volume or volumes on 
which the data set currently resides, 
if it is not cataloged. 

If the data set is cataloged, FROM 
should not be written- 


CVOL= device= s eria1 

specifies the device type and volume 
serial number of the control volume at 
which the catalog search for the data 
set is to begin. 

If neither CVOL nor FROM is written, 
the data set is assumed to be cata¬ 
loged on the system residence volume. 


UNCATLG 

specifies that the catalog entry per¬ 
taining to the data set is to be 
removed. This parameter should be 
used only if the source data set is 
cataloged. 

UNCATLG is ignored if the volume was 
identified by FROM. 


RENAME=name 

specifies that the data set is to be 
renamed, and indicates the new name. 


DSNAME=name 

specifies the fully qualified name of 
the data set to be copied. 

TO=device=list 

specifies the volume or volumes on 
which the data set is to be copied. 

FROM=device=list 

specifies the volume or volumes on 
which the data set currently resides r 
if it is not cataloged. 

If the data set is cataloged, FROM 
should not be written. 

CVOL=device=serial 

specifies the device type and volume 
serial number of the control volume at 
which the catalog search for the data 
set is to begin. 

If neither CVOL nor FROM is written, 
the data set is assumed to be cata¬ 
loged on the system residence volume. 

UNCATLG 

specifies that the catalog entry per¬ 
taining to the source data set is to 
be removed. (The source data set must 
be cataloged.) 

UNCATLG is ignored if the volume was 
identified by FROM. 

CATLG 

specifies that the copy of the data 
set is to be cataloged on the receiv¬ 
ing volume, if it is a direct-access 
volume. If a catalog does not exist 
on the receiving volume, a new catalog 
is created. 

RENAME=name 

specifies that the data set is to be 
renamed, and indicates the new name. 
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Moving a Group of Data Sets (MOVE DSGROUP) 


The MOVE DSGROUP statement is used to 
move groups of data sets that are cataloged 
on the same control volume and whose names 
are partially qualified by one or more 
identical names. For example, a group of 
data sets qualified by the name A.B 
includes data sets named A.B.C and A.B.D, 
but does not include data sets named A.C.D 
or A.D.F. MOVE DSGROUP operations cause 
the specified catalog to be updated auto¬ 
matically unless UNCATLG is specified. The 
INCLUDE and EXCLUDE statements, discussed 
later in this section, can be used to add 
to or delete data sets from the group. 


T T 

Name |Operation|Operand 

1 

T 

[name]|MOVE 

T 

|DSGROUP[=name] 

i 

|TO=device=list 

i 

j[CVOL=device=serial] 

i 

|[PASSWORD] 


j[UNCATLG] 


- X _ 


DSGROUP=name 

specifies a qualified name. All cata¬ 
loged data sets whose names are quali¬ 
fied by this name are to be moved. If 
the name is a fully qualified data set 
name, the operation is performed only 
on that data set. 


DSGROUP 

specifies that all data sets cataloged 
on the specified control volume are to 
be moved. 


TO=device=list 

specifies the volume or volumes to 
which the specified group of data sets 
is to be moved. 


CVOL=device=serial 

specifies the device type and volume 
serial number of the control volume at 
which the catalog search for the data 
sets is to begin. 

If CVOL is omitted, the specified 
group of data sets is assumed to be 
cataloged on the system residence vol¬ 
ume. 

PASSWORD 

specifies that password-protected data 
sets contained in the group are to be 
considered eligible for the moving 
operation. 

If PASSWORD is omitted,, only data sets 
that are not password-protected are 
moved. 

UNCATLG 

specifies that the catalog entries 
pertaining to the specified group of 
data sets are to be removed. 
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Copying a Group of Data Sets (COPY DSGROUP) 


The COPY DSGROUP statement is used to 
copy groups of data sets that are cataloged 
on the same control volume and whose names 
are partially qualified by one or more 
identical names. The source data sets 
remain cataloged unless UNCATLG is speci¬ 
fied. The copies of the data sets are 
cataloged on their receiving volumes if 
CATLG is specified. The INCLUDE and 
EXCLUDE statements, discussed later in this 
section, can be used to add data sets to or 
delete data sets from the group. 


r 

| Name 

i 

r t * “- 1 

Operation|Operand 

r 

| [name] 

L J 

h — + 

COPY j DSGROUP[=name] 

jTO=device=list j 

|[CVOL=device=serial3 
| j [PASSWORD] j 

| | [UNCATLG] j 

j [CATLG] j 


DS GROUP= name 

specifies a qualified name. All cata¬ 
loged data sets whose names are quali¬ 
fied by this name are to be copied. 
If the name is a fully qualified data 
set name, the operation is performed 
only on that data set. 


DSGROUP 

specifies that all data sets cataloged 
on the specified control volume are to 
be copied. 


TO=device=list 

specifies the volume or volumes on 
which the specified group of data sets 
is to be copied. 


CVOL=device=serial 

specifies the device type and volume 
serial number of the control volume at 
which the catalog search for the data 
sets is to begin. 


If CVOL is omitted, the specified 
group of data sets is assumed to be 
cataloged on the system residence vol¬ 
ume. 


PASSWORD 

specifies that password-protected data 
sets contained in the group are to be 
considered eligible for the copying 
operation. 


If PASSWORD is omitted, only data sets 
that are not password-protected are 
copied. 


UNCATLG 

specifies that the catalog entries 
pertaining to the source group of data 
sets are to be removed. 


CATLG 

specifies that the names of the copied 
data sets are to be cataloged on their 
receiving volumes, if they are direct- 
access volumes. If catalogs do not 
exist on the receiving volumes, they 
are created. 
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Moving a Partitioned Data Set (MOVE PDS) 


The MOVE PDS statement is used to move 
partitioned data sets. In addition, it can 
be used to expand a directory and, in 
conjunction with the INCLUDE, EXCLUDE, 
REPLACE, and SELECT statements, to merge 
selected members of several partitioned 
data sets or delete members. MOVE PDS 
causes the specified catalog to be automat¬ 
ically updated unless UNCATLG is specified. 
If the receiving volume already contains a 
partitioned data set with the same name, 
the two are merged. 


r -t- t- 1 

|Name |Operation|Operand 

h-+-+-^ 


j [name] j MOVE |PDS=name j 

| | jTO=device=serial 

j j j |"FROM=device=serial 1 

| j j LCVOL=device=serial J 

| j |[EXPAND=n] 

| j j [UNCATLG] j 

j | |[RENAME=name] 

L-X- X -J 


PDS=name 

specifies the fully qualified name of 
the partitioned data set to be moved. 


TO=device=serial 

specifies the device type and volume 
serial number of the volume to which 
the partitioned data set is to be 
moved. 


FROM=device=serial 

specifies the device type and volume 
serial number of the volume on which 
the partitioned data set currently 
resides, if it is not cataloged. 

If the data set is cataloged, FROM 
should not be written. 


CVOL=device=serial 

specifies the device type and volume 
serial number of the control volume at 
which the catalog search for the par¬ 
titioned data set is to begin. 


If neither FROM nor CVOL is written, 
the partitioned data set is assumed to 
be cataloged on the system residence 
volume. 


EXPAND=n 

specifies the number of 256-byte 
records to be added to the directory 
of the specified partitioned data set. 


UNCATLG 

specifies that the catalog entry per¬ 
taining to the source partitioned data 
set is to be removed. This parameter 
should be used only if the source 
partitioned data set is cataloged. 

If the volume was identified by FROM, 
UNCATLG is ignored. 


RENAME=name 

specifies that the data set is to be 
renamed, and indicates the new name. 
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Copying a Partitioned Data Set (COPY PPS) 


If the data set is cataloged,, FROM 
should not be written. 


The COPY PDS statement is used to copy 
partitioned data sets. In addition, it can 
be used to expand a directory and, in 
conjunction with the INCLUDE, EXCLUDE,, 
REPLACE, and SELECT statements, to merge 
selected members from several partitioned 
data sets or delete members. If the 
receiving device already contains a parti¬ 
tioned data set having the same name as the 
source partitioned data set, the two data 
sets are merged. The source partitioned 
data set remains cataloged unless UNCATLG 
is specified. 


CVOL=device=serial 

specifies the device type and volume 
serial number of the control volume at 
which the catalog search for the par¬ 
titioned data set is to begin. 


If neither FROM nor CVOL is written, 
the partitioned data set is assumed to 
be cataloged on the system residence 
volume. 


j Name j Operation j Operand | 


I- 

-—— -j- ——— - 

- + - 



[name)|COPY 

| PDS=name 



| 

|TO=device=serial 



| 

j ["FROM=device=serial 1 



1 

j LcvOL=device=serialJ 



1 

j[EXPAND=n] 



1 

j[UNCATLG] 



I 

|[CATLG] 



I 

|(RENAME=name) 


L. 

j. 


_J 


EXPAND=n 

specifies the number of 256-byte 
records to be added to the directory 
of the specified partitioned data set. 


UNCATLG 

specifies that the catalog entry per¬ 
taining to the source partitioned data 
set is to be removed. This parameter 
should be used only if the source 
partitioned data set is cataloged. 


PDS=name 

specifies the fully qualified name of 
the partitioned data set to be copied. 

TO=device=serial 

specifies the device type and volume 
serial number of the volume on which 
the partitioned data set is to be 
copied. 

FROM=device=seria1 

specifies the device type and volume 
serial number of the volume on which 
the partitioned data set currently 
resides, if it is not cataloged. 


UNCATLG is ignored if the volume was 
identified by FROM. 


CATLG 

specifies that the copied partitioned 
data set is to be cataloged on the 
receiving volume, if it is a direct- 
access volume. If a catalog does not 
exist on the receiving volume, a new 
catalog is created. 


RENAME=name 

specifies that the data set is to be 
renamed, and indicates the new name. 
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Moving a Catalog (MOVE CATALOG) 


The MOVE CATALOG statement is used to 
move the entries in a catalog without 
moving the data sets associated with those 
entries. Certain entries can be excluded 
from a move operation by means of the 
EXCLUDE statement. If the receiving volume 
contains a catalog, the source catalog is 
merged with it,. 


Copying a Catalog (COPY CATALOG) 


The COPY CATALOG statement is used to 
copy the entries in a catalog without 
copying the data sets associated with these 
entries. Certain entries can be excluded 
from a copy operation with the EXCLUDE 
statement. If the receiving volume con¬ 
tains a catalog, the source catalog is 
merged with it. 


r - r - T - 

|Name |Operation|Operand 


h 




|[name]|MOVE 

I 
I 


j CATALOG[=name] 

|TO=device=serial 
11"CVOL=device=serial “I 
j LFROM=device=serialJ 
. x _ 


| Name 

|Operation)Operand 

|-- 

— f-- 

-+- 

| [name]|COPY 

|CATALOG[=name] 

i 

i 

|TO=device=serial 

i 

i 

IfCVOL=device=seriall 

i 

i 

j L FROM=device=serialJ 

i_ 

JL 

X 


CATALOG^name 

specifies a qualified name. All cata¬ 
log entries whose names are qualified 
by this name are moved. If the name 
is a fully qualified data set name, 
only the catalog entry that 
corresponds to that data set is moved. 

CATALOG 

specifies that all entries in the 
catalog are to be moved. 

TO=device=serial 

specifies the device type and volume 
serial number of the direct-access 
volume to which the specified catalog 
entries are to be moved. 

CVOL=device=seria1 

specifies the device type and volume 
serial number of the control volume at 
which the search for the catalog is to 
beg in. 

F ROM=device=serial 

specifies the device type and volume 
serial number of the volume on which 
an unloaded version of the catalog 
resides. 

If neither FROM nor CVOL is written, 
the catalog is assumed to reside on 
the system residence volume. 


CATA LO G= name 

specifies a qualified name. All cata¬ 
log entries whose names are qualified 
by this name are copied. If the name 
is a fully qualified data set name, 
only the catalog entry that corres¬ 
ponds to that data set is copied. 

CATALOG 

specifies that all entries in the 
catalog are to be copied. 

TO=device=serial 

specifies the device type and volume 
serial number of the direct-access 
volume on to which the specified cata¬ 
log entries are to be copied. 

CVOL=device= serial 

specifies the device type and volume 
serial number of the control volume at 
which the search for the catalog is to 
begin. 

FROM=device=serial 

specifies the device type and volume 
serial number of the volume on which 
an unloaded version of the catalog 
resides. 

If neither FROM nor CVOL is written, 
the catalog is assumed to reside on 
the system residence volume. 
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Including Additional Data in Move and Copy 
Operations (INCLUDE) 


The INCLUDE statement is used to enlarge 
the scope of certain moving and copying 
operations by including a portion of data 
not explicitly defined in a MOVE/COPY 
DSGROUP or MOVE/COPY PDS statement. The 
INCLUDE statement must appear after the 
MOVE or COPY statement whose function it 
modifies. Any number of INCLUDE statements 
can modify a MOVE or COPY statement. 


r - T - T -T 

| Name |Operation|Operand 


|[name]jINCLUDE |DSNAME=name 

| j[MEMBER=membername] 

IrFROM=device=list 1 j 
j |LcvOL=device=serial J j 

L_X-X-j 

DSNAME=name 

specifies the fully qualified name of 
a data set. 

With MOVE/COPY DSGROUP: the named data 
set is included in the group. 

With MOVE/COPY PDS: a member of the 
named partitioned data set is included 
in the operation- 

MEMBER=membername 

With MOVE/COPY PDS: specifies the name 
of a member of the partitioned data 
set named in the DSNAME parameter. 
This member will be merged with the 
partitioned data set that was moved or 
copied. Its record characteristics 
must be the same as those of the data 
set with which it is being merged. 

This parameter must be included when 
modifying a MOVE/COPY PDS statement. 

FROM=device=list 

specifies the volume or volumes on 
which the data set resides,, if the 
data set is not cataloged. 

If the data set is cataloged, FROM 
should not be specified. 

CVOL=device=serial 

specifies the device type and volume 
serial number of the control volume at 
which the catalog search for the data 
set is to begin. 

If both FROM and CVOL are omitted^ the 
specified data set is assumed to be 
cataloged on the system residence vol¬ 
ume . 


Excluding Data from Move and Copy 
Operations (EXCLUDE) 


The EXCLUDE statement is used to re¬ 
strict the scope of certain moving or 
copying operations by excluding a specific 
portion of the data defined in a MOVE/COPY 
DSGROUP,, PDS, or CATALOG statement. 

Partitioned data set members excluded 
from a MOVE PDS operation cannot be recov¬ 
ered (the source data set is scratched)- 
Any number of EXCLUDE statements can modify 
a MOVE/COPY PDS Statement- 

Source data sets or catalog entries 
excluded from a MOVE DSGROUP or MOVE CATA¬ 
LOG operations remain available. Only one 
EXCLUDE statement can modify a MOVE/COPY 
DSGROUP or MOVE/COPY CATALOG statement. 


| Name jOperationjOperand | 

^ - + - + -- ^ 

j[name]j EXCLUDE j(DSGROUP=name 1 j 

j | j1MEMBER=membername) j 

L_X_X_J 


DSGROUP=name 

specifies a qualified name. 

With MOVE/COPY DSGROUP: all data sets 
whose names are qualified by this name 
are excluded from the move or copy 
operation. 

With MOVE/COPY CATALOG: all catalog 
entries whose names are qualified by 
this name are excluded from the move 
or copy operation. 

MEMBER=membername 

With MOVE/COPY PDS: identifies a mem¬ 
ber to be excluded from the parti¬ 
tioned data set being moved or copied. 
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Selecting Partitioned Data Set Members 
(SELECT) 


Replacing Partitioned Data Set Members 
(REPLACE) 


The SELECT statement, used with a 
MOVE/COPY PDS statement, is used to select 
members to be moved or copied, and to 
optionally rename these members. The SE¬ 
LECT and EXCLUDE statements are mutually 
exclusive when used with a MOVE/COPY PDS 
statement. 


r- t-t- 

|Name |Operation|Operand 

I" +-+- 

i [name]j SELECT |MEMBER=(namelist) 

L- JL -J._ 


The REPLACE statement, used with a 
MOVE/COPY PDS statement, is used to combine 
the exclude and include functions for a 
specified member of a partitioned data set. 
The replacing function excludes a member 
from a moving or copying operation and 
replaces it by including a member from 
another partitioned data set. The "new" 
member must have the same name as the "old” 
member and must possess identical record 
characteristics. Any number of REPLACE 
statements can modify a MOVE/COPY PDS 
statement. 


MEMBER=(name[,name]..„) 

identifies the members to be moved or 
copied. These members belong to the 
partitioned data set identified in the 
preceding MOVE/COPY PDS statement. 

MEMBER=((name,newname) [,(name,newname) ] ...) 
identifies the members to be moved or 
copied and gives the new name for each 
member. 


r- t -r- 

(Name |Operation)Operand 


| [name]|REPLACE j DSNAME=name 

j j MEMBER=membername 

| |T FROM=device=s erial1 

j j | l_CVOL=device=serial J 

L- ± -L- 


DSNAME=name 

specifies the fully qualified name of 
the partitioned data set that contains 
the replacing member. 

MEMB ER=membe rnam e 

specifies the name of the member. 

FROM=device=serial 

specifies the device type and volume 
serial number of the volume that con¬ 
tains the partitioned data set named 
in the DSNAME parameter. 

If the partitioned data set is cata¬ 
loged, FROM should not be specified. 

CVOL=device=serial 

specifies the device type and volume 
serial number of the control volume at 
which the catalog search for the par¬ 
titioned data set containing the 
replacing member is to begin. 

If neither FROM nor CVOL are speci¬ 
fied, the partitioned data set is 
assumed to be cataloged on the system 
residence volume. 
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Moving a Volume of Data (MOVE VOLUME) 

The MOVE VOLUME statement is used to 
move all the data sets residing on a 
specified direct-access volume. Catalog 
entries associated with the data sets on 
the source volume are not affected. 


r- t-t-1 

| Name |Operation|Operand 

f-+-+-^ 

|[name]|MOVE |VOLUME=device=serial | 

ITO=device=list 

| j |[PASSWORD] j 

L- X - ± -J 


VOLUME=device=serial 

specifies the device type and volume 
serial number of the source volume. 

TO=device=list 

specifies the volume or volumes to 
which the data sets are to be moved. 

PASSWORD 

specifies that password-protected data 
sets contained on the source volume 
are to be considered eligible for the 
moving operation. 

If PASSWORD is omitted, only data sets 
that are not password-protected are 
moved. 


Copying a Volume of Data (COPY VOLUME) 


The COPY VOLUME statement is used to 
copy all the data sets residing on a 
specified direct-access volume. Catalog 
entries associated with the data sets on 
the source volume are not affected. The 
copied data sets will be cataloged on their 
receiving volumes if CATLG is specified. 


r- t -r- 1 

| Name | Operation) Operand 

f- + -+-4 

j[name]|COPY |VOLUME=device=serial | 

j j |TO=device=list j 

j |[PASSWORD] 

| j [CATLG] j 

L_X_ L _J 


VO LU ME=de vi c e= s e r i a 1 

specifies the device type and volume 
serial number of the source volume. 

TO=device=list 

specifies the volume or volumes onto * 
which the data sets are to be copied. 

PASSWORD 

specifies that password-protected data 
sets contained on the source volume 
are to be considered eligible for the 
copying operation. 

If PASSWORD is omitted, only data sets 
that are not password-protected are 
copied. 


CATLG 

specifies that copied data sets are to 
be cataloged on their respective 
receiving volumes, if they are direct- 
access volumes. If catalogs do not 
exist on the receiving volumes,, they 
are created. 
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Example 


Figure 4 illustrates some typical applications of the IEHMOVE utility program, 

GROUP1 moves a partitioned data set named P.D.S1 from the volume where it resides to 
disk storage volume PI. During the moving operation member M5 is excluded* member M2 
from data set P.D.S2 is added* and member M4 is replaced by a member with the same name 
from a third partitioned data set (P.D.S3). 

GROUP2 copies a catalog from the system residence volume to disk storage volume P2. 
All entries beginning with X.Y are deleted from the operation. 

GROUP3 moves all cataloged data sets whose names begin with X.Y to volume PI. 

GROUP4 moves data set X. Y.Z from disk storage volume PI to tape volume T3 as the 
second data set on the volume. 



| Sample Coding Form 

j- 


. //JOB2 

JOB 

09-550,BROWN 

I// 

EXEC 

PGM=IEHMOVE 

I//SYSPRINT DD 

SYSOUT=A 

|//DD1 

DD 

VOLUME=SER=1234,DISP=OID,UNIT=2302 

|//DD2 

DD 

VOLUME=PRIVATE,UNIT=(2311,,DEFER),DISP=(NEW,KEEP) 

|//SYSUT1 

DD 

UNIT=2311,VOLUME=SER=123,DISP=OLD 

j//DD3 

DD 

VOLUME=PRIVATE,UNIT=(2400-2,,DEFER),DISP=(NEW, KEEP) 

|//SYSIN 

DD 

* 

|GROUP1 

MOVE 

PDS=P-D.SI,TO=2311=Pl 

1 

EXCLUDE 

MEMBER=M5 

1 

INCLUDE 

DSNAME=P.D.S2,MEMBER=N2 

1 

REPLACE 

DSNAME=P.D.S3,ME MBE R= M4 

j GROUP2 

COPY 

CATALOG,TO=2311=P2 

1 

EXCLUDE 

DSGROUP=X. Y 

j GROUP3 

MOVE 

DSGROUP=X.Y,TO=2311=Pl 

GROUP4 

MOVE 

DSNAME=X.Y.Z,FROM= 2 311=P1« TO=2 4 00-2=(T3 » 2) 

|/* 

l 



Figure 4. 

Moving 

and Copying Data 


i 

A 


j 


* 
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LISTING SYSTEM CONTROL DATA 


The IEHLIST utility program lists system control data- It is executed or invoked with 
the symbolic name IEHLIST- The utility statements can request the following types of 
listings: 


• Entries in a catalog. 

• Entries in the directory of one or more partitioned data sets. 

• Entries in a volume table of contents. 

Any number of listings can be requested in a single job step. 


Listing a Catalog (LISTCTLG) 


The LISTCTLG statement is used to 
request a listing of either the entire 
catalog or a specified portion of a cata¬ 
log. The listing includes the fully quali¬ 
fied name of each cataloged data set and 
the serial number of the volume on which it 
resides. 


| Name |Operation|Operand | 


j [name]j LISTCTLG j [VOL=device=serial] 
I[NODE=name] 


VOL=device=serial 

specifies the device type and volume 
serial number of the control volume on 
which the specified portion of the 
catalog resides. 

If CVOL is omitted, the catalog is 
assumed to reside on the system resi¬ 
dence volume. 

NODE=name 

specifies a qualified name. All data 
set entries whose names are qualified 
by this name are listed. 

If NODE is omitted,, all data set 
entries are listed. 


Listing Partitioned Data Set Directories 
(LISTPDS) 


The LISTPDS statement is used to request 
a listing of the directories of one or more 
partitioned data sets that reside on the 
same volume. 


r - r - r - n 

|Name |Operation!Operand | 

f--j*-+- 

|[name](LISTPDS j [VOL=device=serial] 

| JDSNAME=(namelist) j 

I-X-L-J 


VOL=device=serial 

specifies the device type and volume 
serial number of the volume on which 
the partitioned data sets reside. 

If VOL is omitted, the data sets are 
assumed to reside on the system resi¬ 
dence volume. 

D.SNAME= (name [, name ]... ) 

specifies the fully qualified names of 
the partitioned data sets whose direc¬ 
tories are to be listed. A maximum of 
ten names is allowed. If the list 
consists of a single name, the paren¬ 
theses can be deleted. 
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Listing a Volume Table of Contents 
(LISTVTOC) 


The LISTVTOC statement is used to 
request a partial or complete listing of 
the entries in a specified volume table of 
contents. 


r 

| Name 

1 

T T ~ 

|Operation|Operand 

_L _L 

-1 

1 

4 

r 

| [name] 

T 

|LISTVTOC 

| (DUMP 1 

1 


i 

1 FORMAT | 



i 

| [DATE= dddyy] 



i 

| [VOL=device=serial] 



i 

| [DSNAME=(namelist)] 


L 

■X 

-J 


DUMP 

specifies that the listing is to be in 
unedited, hexadecimal form. 

FORMAT 

specifies that the listing is to be 
edited for each data set into the 
following categories: 

• Data set name. 

• Creation date. 

• Expiration date. 

• Password indication. 

• Organization. 

• Extent(s). 

• Volume serial number. 


The last line in the listing indicates 
how much space remains in the volume 
table of contents. 


DATE=dddyy 

specifies that each entry that expires 
before this date is to be flagged with 
an asterisk (*). The date is rep¬ 
resented by: 


ddd day of the year 

yy last two digits of the year 


If DATE is omitted, no asterisks 
appear in the listing. 

VOL=device=serial 

specifies the device type and volume 
serial number of the volume whose 
table of contents is to be listed. 

If VOL is omitted, the system resi¬ 
dence volume is assumed. 


DSNAME=(name[,name]...) 

specifies the fully qualified names of 
the data sets whose entries are to be 
listed. A maximum of ten names is 
allowed. 


If DSNAME is omitted, the entire vol¬ 
ume table of contents is listed. 



* 



Example 


Figure 5 illustrates the three listing functions of the IEHLIST utility program. The 
operations are described as comments. 


Sample Coding Form 


//JOB3 

JOB 

09-550,, BROWN 

COMMENTS 

1// 

EXEC 

PGM=IEHLIST 



I//SYSPRINT DD 

SYSOUT=A 



j//DD1 

DD 

VOLUME=SER=1234,DISP=OLD,UNIT=2302 


|//DD2 

DD 

VOLUME=PRIVATE,UNIT=(2 311,,DEFER) 

,DISP= 

(NEW,KEEP) 

j//SYSIN 

DD 

* 



| 

LISTCTLG 

MODE=A.B 

LISTS 

A.B ENTRIES 

| 

LISTVTOC 

DATE=06965,VOL=2311=P2 

LISTS 

VTOC OF P2 

i 

LISTPDS 

DSNAME= (P. D. Sl„ P. D. S2 , P.D.S4) 

LISTS 

DIRECTORIES 

i/* 






Figure 5. Listing System Control Data 


* 


f 
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SECTION 2: 


DATA SET UTILITIES 


Data set utility programs manipulate 
data ranging from fields within a logical 
record to entire data sets. They include: 


• IEBCOPY — a program that copies or 
merges partitioned data sets. 


• IEBGENER — a program that copies 
records from a sequential data set or 
converts a data set from sequential to 
partitioned organization. 


• IEBCOMPR — a program that compares 
records in sequential or partitioned 
data sets. 


• IEBPTPCH — a program that prints or 
punches records that reside in a 

sequential or partitioned data set. 


• IEBUPDAT — a program that updates a 
symbolic library. 


Concatenated partitioned data sets or con¬ 
catenated data sets with unlike attributes 
(record characteristics or devices) are not 
supported by these programs. 


Job Control Statement Requirements 


Data set utility programs can be intro¬ 
duced as jobs or job steps and are executed 
in response to job control statements and 
utility statements. The job control state¬ 
ments used are: 


• A JOB statement. 

• An EXEC statement that identifies the 
data set utility program to be execut¬ 
ed. 

• A DD statement named SYSPRINT that 
defines a sequential data set used for 
message output. 

• DD statements named SYSUT1 and SYSUT2 
that define the object data sets. Each 
statement must identify an object data 
set and its location with DSNAME, UNIT, 
and VOLUME parameters, and must give 
its disposition with DISP. The DCB 
subparameters RECFM, BLKSIZE, and LRECL 
(if required) must be available to the 
utility program through either the DD 
statement or the data set label. Other 
DD statement parameters can be used as 
required. 

• A DD statement named SYSIN that defines 
a sequential data set used for utility 
statement input. 


Figure 6 illustrates a set of job con¬ 
trol statements used to execute a data set 
utility program. Execution can be simpli¬ 
fied by cataloging procedures, as described 
in the introduction to "Section 1: System 
Utilities." 


Data set utility programs can also be 
employed as subroutines by use of the 
linkage conventions of the IBM System/360 
Operating System. At the completion or 
termination of the utility program, the 
highest return code encountered within 
either the program or its exit routines is 
passed to the calling program. Invocation 
of utility programs, and linkage conven- 
tionsv are discussed in Appendix B. 



f m 1111 



mazmm 


C 

1 -- 

DCB-lRECFM— XXX. BLKSIZE=nn„LRECL=nn)__ 



///SYSPRINT 


_ DD SYSOUT=A _ 

(//stepname EXEC PGM=proqname 
^//jobname (JOB statement) 


Figure 6. Executing a Data Set Utility Program 


Section 2: Data Set Utilities 
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COPYING AND MERGING PARTITIONED DATA SET MEMBERS 


The IEBCOPY utility program can copy a partitioned data set or, in effect, merge two 
partitioned data sets. It is executed or invoked with the symbolic name IEBCOPY. 

A partitioned data set is expanded or compressed by adding or omitting members from an 
operation. Merging is accomplished by the copying of members from the input data set to 
an existing output data set. In addition to being copied from one volume to another, a 
partitioned data set can be copied onto its own volume, provided its data set name is 
changed on the output DD statement. The input and output data sets are defined in DD 
statements named SYSUT1 and SYSUT2,, respectively. 

Reblocking is requested by specifying a new maximum block length on the DD statement 
named SYSUT2• Both fixed-length and variable-length records can be reblocked. If keys 
are present, or if note lists are present and a total copy is requested,, reblocking is 
not permitted. If note lists are present and a selective copy is requested, reblocking 
is permitted and the note lists are deleted. 

Utility Control Statements: The utility control statements for the IEBCOPY program are: 

• COPY (optional). 

• MEMBER (optional). 

The COPY statement, if present,, must be the first utility statement. If no utility 
statements appear in the SYSIN data set, the entire partitioned data set defined by 
SYSUT1 is copied. 




# 


COPY Statement 


MEMBER Statement 


The COPY statement is required if the 
copying or merging operation deals only 
with selected members of a partitioned data 
set. It is used in conjunction with the 
MEMBER statement to select members. A copy 
operation can be either inclusive or exclu¬ 
sive. An inclusive operation is useful for 
copying a small number of members; an 
exclusive operation is useful for copying 
many members. If the COPY statement con¬ 
tains a blank operand, the entire parti¬ 
tioned data set is copied. 


r- t-t- 1 

| Name |Operation|Operand 

f - + -+-^ 

| (name] jcOPY jrTYPCOPY= I,MAXNAME= n“1 j 

j L TYPCOPY=E,MAXNAME=n J j 
I_1-1-J 


TYPCOPY=I (inclusive operation) 

specifies that the members identified 
in the MEMBER statement are to be 
included in the operation. 

TYPCOPY=E (exclusive operation) 

specifies that the members identified 
in the MEMBER statement are to be 
excluded from the operation. 

MAXNAME=n 

specifies a number no less than the 
total number of member names and ali¬ 
ases listed in the MEMBER statement. 


The MEMBER statement is used to identify 
the one or more members of a partitioned 
data set that are to be included or exclud¬ 
ed from an operation,, and to transfer 
aliases to the output directory. Table 3 
illustrates the combined use of COPY and 
MEMBER statements to direct the functions 
of the IEBCOPY program. 


r - T -r-1 

| Name |Operation!Operand | 

f-+-+-^ 

| [name](MEMBER |NAME=(namelist) j 

L_i-L-J 


NAME=(list of names and aliases) 

identifies the members to be included 
in, or excluded from, the operation. 
A member can be referred to by its 
name,, its aliases, or both. 

In addition to a member name, one or 
more alias names can be included in 
the output directory, if they appeared 
in the input directory. If a member 
is identified only by an alias, that 
alias is designated as the member name 
in the output directory. If a member 
is identified by more than one alias, 
the alias with the lowest collating 
value is designated the member name in 
the output directory; all other alias 
names are retained. 



» 
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Table 3, Use of COPY and MEMBER Statements in the IEBCOPY Program 

r- T - 


To Perform a 


The SYSIN Data Set Must Contain 


Copy of the entire 
partitioned data set 


no control statements 


OR 


(name COPY 


Selective copy 
(inclusive) 


(name MEMBER NAME=(list of members to be copied) 
('name COPY TY PCOP Y= I, MAXNAME=n 


Selective copy 
(exclusive) 


fname MEMBER NAME=(list of members to be excluded) 
(''name COPY TYPCOPY=E„ MAXNAME=n 


Example 


Figure 7 illustrates the selective copying of members named MBR3 f MBR6, and MBR9 from 
the partitioned data set identified in SYSUT1. 


j Sample Coding Form j 

f-- \ 

|//COPY JOB 09-660»D.P.BROWN 

j// EXEC PGM=IEBCOPY 

j//SYSPRINT DD SYSOOT=A | 

| //SYSUT1 DD (Parameters defining the input data set.) 

|//SYSUT2 DD (Parameters defining the output data set.) 

j //SYSIN DD * 

j COPY TYPCOPY=I,MAXNAME=3 | 

j MEMBER NAME=(MBR3,MBR6,MBR9) I 

|/ + 

L-j 


Figure 7. Copying Partitioned Data Set Members 
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COPYING AND MODIFYING RECORDS 


The IEBGENER program can copy a sequential data set or generate a partitioned data set 
from sequential input. It is executed or invoked with the symbolic name IEBGENER, Both 
operations can include the following editing facilities: 

• Rearrangement and omission of data fields. 

• Addition of literal fields. 

• Conversion of data fields. 

In addition, user exits are provided at appropriate places for routines that process user 
labels, manipulate input data, create keys, and handle uncorrectable input/output errors. 
Interpretation of exit routine return codes by this program is discussed in Appendix A. 

The input data set, defined in a DD statement named SYSUT1,, must be a sequential data 
set, and can contain fixed-length, variable-length,, or undefined-length records. 

The output data set, defined in a DD statement named SYSUT2, can be either sequential 
or partitioned. Fixed—length and variable—length records can be reblocked by the 
specification of a new maximum block length on the output DD statement. If the output 
data set resides on a direct-access device, keys cannot be retained with reblocking, 
except through the use of the appropriate user exit. 


Utility Control Statements: The utility control statements for the IEBGENER program are: 


• GENERATE (optional). 

• EXITS (optional). 

• MEMBER (optional). 

• RECORD (optional). 

The GENERATE statement,, if present,, must be the first utility statement. If user exits 
are used, the EXITS statement follows the GENERATE statement. If no utility statements 
appear in the SYSIN data set, the entire SYSUT1 data set is copied sequentially. 


GENERATE Statement 


The GENERATE statement must appear 
before other statements. If it contains 
errors,, or is inconsistent with other 
statements,, the program is terminated. 


| Name |Operation|Operand 

. i i - j 

r t 

| [name]1 GENERATE 

1 1 

1 1 

1 1 

| [MAXNAME= n1 
j[MAXFLDS=n] 

|[MAXGPS=n] 
j[MAXLITS=n] 

_-L 



MAXNAME=n 

specifies a number that is no less 
than the total number of member names 
and aliases appearing in subsequent 
MEMBER statements. MAXNAME is 
required if there are one or more 
MEMBER statements. 


MAXFLDS=n 

specifies a number that is no less 
than the total number of FIELD param¬ 
eters appearing in subsequent RECORD 
statements. MAXFLDS is required if 
there are any FIELD parameters in 
subsequent RECORD statements. 


MAXGPS=n 

specifies a number that is no less 
than the total number of IDENT param¬ 
eters appearing in subsequent RECORD 
statements. MAXGPS is required if 
there are any IDENT parameters in 
subsequent RECORD statements. 


MAXLITS=n 

specifies a number that is no less 
than the total number of characters 
contained in the FIELD literals of 
subsequent RECORD statements. MAXLITS 
is required if the FIELD parameters of 
subsequent RECORD statements contain 
literals. 
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EXITS Statement 


MEMBER Statement 


The EXITS statement is used to identify 
exit routines supplied by the user. The 
exits OUTHDR and OUTTLR are ignored if the 
output data set is partitioned. Linkages 
to and from exit routines are discussed in 
Appendix A. 


The MEMBER statement provides the name 
and aliases of a member that is to be 
created. The record statements that follow 
a MEMBER statement pertain to the named 
member until a new MEMBER statement is 
encountered. If no MEMBER statements are 
included* the output data set is organized 
sequentially. 


r- t-t-- ~ 1 

|Name |Operation|Operand 

j.-+-+----i 

[name] |EXITS | [INHDR=routinenamel I 

|[OUTHDR=routinename3 
|[lNTLR=routinename] 

|[OUTTLR=routinename] 

|[KEY=routinename] 

|[DATA=routinename] 

I[IOERROR=routinename] 

L_i___ J 


r- t-t 

|Name |Operation!Operand 


| [name]jMEMBER |NAME=(name[*alias]...) 

I_A-L- 


1 


I 


NAME=(name[* alias]...) 

specifies a member name followed by a 
list of its aliases. 


INHDR=routinename 

specifies the symbolic name of a rou¬ 
tine that processes user input header 
labels. 


OUTHDR=routinename 

specifies the symbolic name of a rou¬ 
tine that creates user output header 
labels. 


I NT LR= r ou t i n ename 

specifies the symbolic name of a rou¬ 
tine that processes user input trailer 
labels. 


OUTTLR=routinename 

specifies the symbolic name of a rou¬ 
tine that creates user output trailer 
labels. 


KEY=routinename 

specifies the symbolic name of a rou¬ 
tine that creates the output record 
key. 


DATA=routinename 

specifies the symbolic name of a rou¬ 
tine that modifies the input record 
before it is processed. 


IOERROR= routinename 

specifies the symbolic name of a rou¬ 
tine that handles permanent 
input/output error conditions. 


RECORD Statement 


The RECORD statement is used to define a 
"record group"* and to supply editing 
information. A record group consists of 
one or more records that are to be edited 
identically. The RECORD statement defines 
a record group by identifying the last 
record of the group with a literal name. 

The RECORD statement can contain any 
number of FIELD parameters. If no RECORD 
statement is used, the entire input data 
set or member is copied without editing. 


[Name [operation} 

i i .. _ . , i 

Operand | 

_ j 

r t t 

[name]|RECORD 

1 

1 1 

1 1 

1 1 

L A — 4 

“IDENT=(length* 1 name* * 1 | 
input-location) J j 
”FIELD=( [length]* [input~|j 
loc ation-or-'1it era1 f ] j 
*[conversion]*[output- j 
location]) . . . J| 

J 


IDENT=(length*'name' # input-location) 

identifies the last record of the 
input record group to which the FIELD 
parameters apply. 


length : specifies the length (in 
bytes) of the identifying name. The 
length cannot exceed 8 characters. 
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'name* : specifies the exact literal 
that identifies the last input record 
of a record group. 


input-location ; specifies the starting 
location of the field that contains 
the identifying name in the input 
records. 

If IDENT is omitted or if no match for 
•name* is found r the remainder of the 
input data is considered to be in one 
record group, i.e., subsequent RECORD 
and MEMBER statements are ignored. 


FIELD=([length], [input-loc* n-or-•literal•], 
[conversion],[output-location])... 

specifies the field processing and 
editing information. FIELD parameters 
can determine the logical record 
length of output records. 

length : specifies the length (in 
bytes) of the input field to be pro¬ 
cessed. If a length is not specified, 
80 is assumed. 

input-location or "literal* : specifies 
the starting byte of the field to be 
processed or, if enclosed in apos¬ 
trophes, the literal (maximum length 
of 40 bytes) to be placed in the 
specified output location. If an 
input location is not specified, 1 is 
assumed. If the literal contains 
apostrophes, each must be written as 
two consecutive apostrophes. 


conversion : specifies a 2-byte code 
that indicates the type of conversion 
to be performed on this field, as 
follows: 


r r - x -*i 

I I |Output length) 

I j (Input lengthj 


Codej Conversion 

j. i 

is L) 

PZ 

i T 

|Packed to unpack-| 

2L-1 

ZP 

j ed decimal mode j 
|Unpacked to pack-j 

L/2+C * 

HE 

j ed decimal mode j 
jH-set BCD to j 

L 


j EBCDIC mode 
-X x . 



| *If L is odd, C is 1/2; if L is| 
j even, C is 1. j 

l -j 


If a conversion is not specified, the 
field will be moved to the output area 
without change. 


output-location : specifies the start¬ 
ing location of this field in the 
output records. If an output location 
is not specified, 1 is assumed. 

Contents of unspecified fields in the 
output records are not erased or modi¬ 
fied by the IEBGENER program. These 
contents remain the same as they were 
before the program was executed. 


Examples 


Figure 8 illustrates the generation of a two-member partitioned data set from a 
sequential data set. The last record of GROUP1 is identified with the literal 'REC15*; 
the identification field is located in bytes 2 through 6 of the input records. GROUP2 
contains the remainder of the input data set. 

Figure 9 illustrates the editing of records in a sequential data set. The records are 
edited in the following manner: 

• Asterisks are placed in positions 1 to 10. 

• Bytes 1 to 5 of the input record are converted from H-set BCD to EBCDIC mode 
and moved to positions 11 to 15. 

• An equal sign is placed in byte 16. 

• Bytes 20 to 35 of the input record are converted from packed to unpacked 
decimal mode and moved to position 17 to 47. 

• Blanks are placed in positions 48 to 60. 

Two exit routines, ERR and INHDRTN, are used. 
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Sample Coding Form 


f- 

|//GEN JOB 09-660„D.P.BROWN 

j// EXEC PGM=IEBGENER 

|//SYSPRINT DD SYSOUT=A 

|//SYSUT1 DD (Parameters defining the input sequential data set.) 

|//SYSUT2 DD (Parameters defining the output partitioned data set.) 

|//SYSIN DD * 

j GENERATE MAXNAME=5„MAXFLDS=2„MAXGPS=2 

EXITS INHDR=INHDRTN,INTLR=INTLRTN»KEY=KEYEXIT 

j MEMBER NAME=(MBR3,ALS1, ALS2) 

| GROOP1 RECORD IDENT= (5,, * REC15', 2) , FIELD= (, , HE) 

| MEMBER NAME= (MBR4, ALS 3) 

j GROOP2 RECORD FIELD=(,„HE) 

[/• 

Figure 8- Generating a Partitioned Data Set From Sequential Input 




Sample Coding Form 


|//EDIT JOB 09-660,D.P.BROWN 

|// EXEC PGM=IEBGENER 

j//SYSPRINT DD SYSOUT=A 

j//SYSUT1 DD (Parameters defining the input sequential data set.) 

|//SYSUT2 DD (Parameters defining the output sequential data set.) 

|//SYSIN DD * 

j GENERATE MAXFLDS=5„MAXLITS=24 

j EXITS IOERROR=ERR„INHDR=INDRTN 

| RECORD FIELD= (10, *********** ' ,,, 1) ,FIELD= (5,1 ,HE, 11) ,, 

j FIELD=(1,•=*,,16),FIEID=(16,20,PZ„ 17), 

j FIELD= (13, ' V,,48) 

|/* _ 

Figure 9, Editing the Records of a Sequential Data Set 
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COMPARING RECORDS 


The IEBCOMPR utility program compares two identically organized data sets at the 
logical record level. The data sets can be either sequential or partitioned. In 
addition, user exits are provided at appropriate places for routines that process user 
labels, handle error conditions, and modify source records. Interpretation of exit 
routine return codes by this program is discussed in Appendix A. This program is 
executed or invoked with the symbolic name IEBCOMPR. The input data sets to be compared 
are defined in the DD statements named SYSUT1 and SYSUT2. 

Two sequential data sets are considered "unequal” if: 

• One data set contains more records than the other. 

• Corresponding records are not identical. 

• Corresponding keys are not identical. 

If comparison of two records shows them to be unequal, both record and block numbers, the 
names of the DD statements that define the data sets, and the unequal records are 

printed. 

Two partitioned data sets can be compared if all the names in one directory have 
counterpart entries in the other. The comparison is made on members identified by these 
entries, and corresponding user data. Two members are considered "unequal" if: 

• Corresponding members do not contain an equal number of records. 

• Note lists are not in the same position within corresponding members. 

• Corresponding records are not identical. 

• Corresponding keys are not identical. 

If comparison of two records shows them to be unequal, the record and block numbers, the 
names of the DD statements that define the data sets, and the unequal records are 

printed. 

Utility Control Statements: The utility control statements for the IEBCOMPR program are: 


• COMPARE (optional). 

• EXITS (optional). 

The COMPARE statement, if present, must be the first utility statement. If no utility 
statements appear in the SYSIN data set, the two input data sets are assumed to be 
sequential. 


COMPARE Statement TYPORG=PS 

specifies that the input data sets are 
organized sequentially. 

The COMPARE statement is used to indi¬ 
cate the type of data set organization. 


r- t-t- 

| Name |Operation(Operand 


| (name]j COMPARE j( TYPORG=PS I 
| \ TYPORG=PO J 


I 

I 

I 

J 


TYPORG=PO 

specifies that the input data sets are 
partitioned. 


If TYPORG is omitted, the input data 
sets are assumed to be sequential. 
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EXITS Statement 


The EXITS statement is used to identify 
exit routines supplied by the user. Exits 
to label processing routines are ignored if 
partitioned data sets are being compared. 
Linkages to and from exit routines are 
discussed in Appendix A. 


r- t-t- 

| Name |Operation|Operand 

-+-+- T -7“ 

| [name]j EXITS | [INHDR=routinename] 

| j |[INTLR=routinename] 

| | j [ERROR=routinename] 

|[PRECOMP=routinename] 
L_-L-X- 


I 

A 

I 

I 

1 


INHDR=ro ut inename 

specifies the symbolic name of a rou¬ 
tine that processes user input header 
labels. 


If INHDR is omitted, the user header 
labels from both input data sets are 
printed. 


INTLR=routinename 

specifies the symbolic name of a rou¬ 
tine that processes user input trailer 
labels. 

If INTLR is omitted, the user trailer 
labels from both input data sets are 
printed. 


ERROR=routinename 

specifies the symbolic name of an 
error routine to be given control 
after each unequal comparison. 

Sequential Data Sets : If ERROR is 
omitted and ten successive unequal 
comparisons occur, processing is ter¬ 
minated. 

Partitioned Data Sets : If ERROR is 
omitted • and ten successive unequal 
comparisons occur, processing contin¬ 
ues with the next member. 


PRECOMP=routinename 

specifies the symbolic name of a rou¬ 
tine that modifies logical records 
from either or both of the input data 
sets before they are compared. 

If PRECOMP is omitted,, neither input 
data set is modified* 


Example 

Figure 10 illustrates the comparing of two sequential data sets. Three exit routines, 
INHDRTN, INTLRTN, and MODIFY, are used. 


r 

1 


Sample Coding Form 

1 

1 

4 

t* 

//COMP 

JOB 

09-660,D-P.BROWN 


|// 

EXEC 

PGM=IEBCOMPR 


j//SYSPRINT 

DD 

SYSOUT=A 


j//SYSUTl 

DD 

(Parameters defining the first input data set.) 


|//SYSUT2 

DD 

(Parameters defining the second input data set.) 


1//SYSIN 

DD 

* 


COMPARE 

TYPORG=PS 


EXITS 

I/* 

INHDR=INHDRTN, INTLR=INTLRTN, PRECOMP= MODIFY 

J 


Figure 10. Comparing the Records in Two Sequential Data Sets 
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PRINTING AND PUNCHING RECORDS 


The IEBPTPCH utility program prints or punches all,, or selected portions of,, a 
sequential or partitioned data set. It is executed or invoked with the symbolic name 
IEBPTPCH, and has the following optional editing facilities: 

• Rearrangement and omission of data fields. 

• Conversion of data fields or records from packed to unpacked decimal mode and 
from alphameric to hexadecimal representation. 

In addition,, user exits are provided at appropriate places for routines that process user 
labels and manipulate input data. Interpretation of exit routine return codes by this 
program is discussed in Appendix A. Directories of partitioned data sets can be printed 
or punched by being defined as sequential data sets. 


The input data set, defined in a DD statement named SYSUT1, can be either sequential 
or partitioned, with variable-length, fixed—length, or undefined-length records. The 
input mode may be hexadecimal or EBCDIC,, packed or unpacked decimal. Packed decimal mode 
should be converted to unpacked decimal mode to ensure that all characters are printable. 


The output data set,, defined in a DD statement named SYSUT2, is printed or punched. 
Title and subtitle records, if requested, appear at the top of each page of printed 
output or at the start of the deck of punched output. 


Records can be printed or punched to meet either standard specifications or user 
specifications. The standard specifications are as follows: 

• The output mode (hexadecimal or EBCDIC,, packed or unpacked decimal) is the same 
as the input mode. 

• Each logical record begins on a new printed line or punched card. 

• Each printed line consists of 12 groups of eight characters separated by two 
blanks. Each punched card contains up to 80 contiguous bytes of information. 

• Characters that cannot be printed appear as blanks. 

Other formats can be specified by RECORD statements, provided that the resulting records 
do not exceed 120 characters for printed output, or 80 characters for punched output. If 
sequence numbers are requested, the record to be punched can contain only 72 characters. 


Utility Control Statements: The utility control statements for the IEBPTPCH program are: 

• PRINT or PUNCH. 

• TITLE (optional). 

• EXITS (optional). 

• MEMBER (optional). 

• RECORD (optional). 

The PRINT or PUNCH statement must be the first utility statement. 
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PRINT or PUNCH Statement 


The 

initiate 


PRINT or PUNCH statement is used to 
the utility operation. 


For a card punch the number selects 
the card stacker,, as follows: 

1 - first stacker 

2 - second stacker 

If CNTRL is omitted, 1 is assumed. 




# 




r- t-t- 

| Name |Operation|Operand 

-+-- 


[name] 


PRINT 

PUNCH 


TYPORG—PS 


TYPORG=PO| 
TOTCONV=XEl 
TOTCONV= P Z J 
[CNTRL=n] 
riNITPG=n"| 
LCDSEQ=n J 
rMAXLINE=n] 
LcDINCR=n J 
[STOPAFT=n] 
[SKIP=n] 

[MAXN AME= n] 
[MAXFLDS=n] 
[MAXGPS=n] 
[MAXLITS=n] 


L_X-1- 




TYPORG=PS 

specifies that the input data set is 
organized sequentially. 

TYPORG=PO 

specifies that the input data set is 
partitioned. 


INITPG=n (PRINT only) 

specifies the initial page number. 
Printed pages are numbered sequential¬ 
ly thereafter. 

If INITPG is omitted, 1 is assumed. 


CDSEQ=n (PUNCH only) 

specifies the initial sequence number 
of a deck of punched cards. This 
value can be up to 8 digits and 
occupies columns 73 to 80. Sequence 
numbering is reinitialized for each 
member of a partitioned data set* 

If CDSEQ is omitted, the cards are not 
numbered. If n is omitted, 00000000 
is assumed. 


MAXLINE=n (PRINT only) 

specifies the maximum number of lines 
to a printed page. Spaces, titles, 
and subtitles must be included in this 
number. 


If TYPORG is omitted, PS is assumed. 


If MAXLINE is omitted, 60 is assumed. 


TOTCONV=XE 

specifies that data is to be printed 
or punched in 2-character-per-byte 
hexadecimal representation, e.g., C3 
40 F4 F6. 

If TOTCONV= XE is not specified, data 
will be printed or punched in 
1-character-per-byte alphameric rep¬ 
resentation. The above example would 
appear as C 46. 

TOTCONV=PZ 

specifies that data in packed decimal 
mode is to be converted to unpacked 
decima1 mode. 

If TOTCONV=PZ is omitted, data is not 
converted. TOTCONV is not valid if 
RECORD statements are present. 

CNTRL=n 

specifies a control character for the 
output device. For a printer the 
number indicates line spacing, as 
follows: 


CDINCR=n (PUNCH only) 

specifies the increment to be used in 
generating sequence numbers.. 

If CDINCR is omitted, 10 is assumed. 


STOPAFT=n 

Sequential data sets : specifies the 
number of logical input records to be 
printed or punched. 

Partitioned data sets: specifies the 
number of logical input records to be 
printed or punched in each member. 

If STOPAFT is specified and RECORD 
statements are present, the operation 
is terminated when the STOPAFT count 
is satisfied or at the end of the 
first record group, whichever occurs 
first. 

If RECORD statements are absent and 
STOPAFT is omitted, processing will 
continue until the end of data is 
reached. 


1 - single spacing 

2 - double spacing 

3 - triple spacing 
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SKIP=n 

specifies that every "nth" record is 
to be printed or punched. 

If SKIP is omitted* successive logical 
records are printed or punched. 


output location : specifies the start¬ 
ing position at which the title (or 
subtitle) is to be placed in the 
output record. If an output location 
is not specified* 1 is assumed. 


MAXNAME=n 

specifies a number no less than the 
total number of subsequent MEMBER 
statements. 

If MAXNAME is omitted and there are 
one or more MEMBER statements* the 
PRINT or PUNCH request is terminated. 

MAXFLDS=n 

specifies a number no less than the 
total number of FIELD parameters 
appearing in subsequent RECORD state¬ 
ments . 

If MAXFLDS is omitted* 0 is assumed. 
MAXGPS=n 

specifies a number no less than the 
total number of IDENT parameters 
appearing in subsequent RECORD state¬ 
ments . 

If MAXGPS is omitted* 0 is assumed. 


EXITS Statement 


The EXITS statement is used to identify 
exit routines supplied by the user. Exits 
to label processing routines are ignored if 
the input data set is partitioned. Link¬ 
ages to and from exit routines are dis¬ 
cussed in Appendix A. 


r - 

| Name 

i 

|Operation|Operand 

J. 

r 

|[name] 

j EXITS 

T 

|[INHDR=routinename] 

i 

1 

|[INTLR=routinename] 

i 

1 

|[INREC=routinename] 

i 

1 

j [OUTREC=routinename] 

L 

x _ 

_L 


1 

I 

I 


J 


INHDR=routinename 

specifies the symbolic name of a rou¬ 
tine that processes user input header 
labels. 


MAXLITS=n 

specifies a number no less than the 
total number of characters contained 
in the IDENT literals of subsequent 
RECORD statements. 

If MAXLITS is omitted* 0 is assumed. 


TITLE Statement 


The TITLE statement is used to request 
title and subtitle records. A first TITLE 
statement defines the title and a second 
defines the subtitle. 


INTLR=routinename 

specifies the symbolic name of a rou¬ 
tine that processes user input trailer 
labels. 

INREC=routinename 

specifies the symbolic name of a rou¬ 
tine that manipulates each logical 
record before it is processed. 

OUTREC=routinename 

specifies the symbolic name of a rou¬ 
tine that manipulates each logical 
record before it is printed or 
punched. When standard specifications 
are used* this exit is not available. 


r- t-t- 1 

|Name |Operation|Operand 

F- + -+-^ 

j [name]j TITLE |{ITEM=(* title* * j 

| j | output-location)>...j 

l -x- ± -J 

{ITEM=(*title* * output- location) 

specifies title or subtitle informa¬ 
tion. 

'title* : specifies the title (or 

subtitle) literal* (maximum length of 
40 bytes) enclosed in apostrophes. If 
the literal contains apostrophes* each 
must be written as two consecutive 
apostrophes. 


MEMBER Statement 


The MEMBER statement is used to identify 
members to be printed or punched. All 
RECORD statements that follow a MEMBER 
statement pertain to the named member until 
a new MEMBER statement is encountered. 

If no MEMBER statement appears* and a 
partitioned set is being processed* all 
members of the data set are printed or 
punched. If one or more MEMBER statements 
appear* the PRINT or PUNCH statement must 
specify TYPORG=PO. 
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r - T - T - 

|Name |Operation|Operand 


-+- 

| [name]|MEMBER 

| (NAME=membername) 

1 1 

j{NAME=alias j 



L-X-X. 


I 

I 

I 


I NAME=membername| 

NAME=alias | 

identifies a member by its member name 
or alias. 


RECORD Statement 


length : specifies the length (in 
bytes) of the field that contains the 
identifying name in the input records. 


"name* : specifies the exact literal 
that identifies the last record of a 
record group. If the literal contains 
apostrophes,, each must be written as 
two consecutive apostrophes. 

input-location : specifies the starting 
location of the field that contains 
the identifying name in the input 
records. 






m 



The RECORD statement is used to define a 
record group that is to be printed or 
punched to the user's specifications. A 
record group consists of one or more 
records to be edited identically. The 
RECORD statement can contain one IDENT 
parameter and any number of FIELD param¬ 
eters . 


FIELD=(length,(input-location),(conversion) 
„(output-location) ) . .. 

specifies the field processing and 
editing information. 

length : specifies the length (in 

bytes) of the input field to be pro¬ 
cessed. 


A RECORD statement referring to a parti¬ 
tioned data set for which no members have 
been named need contain only FIELD param¬ 
eters. These are applied to the records in 
all members of the data set. 

If no RECORD statements appear, the 
entire data set,, or named member, is print¬ 
ed or punched to standard specifications. 
However, if a RECORD statement is used,, all 
data following the record group it defines 
must be defined with other RECORD state¬ 
ments . 


r~ 

|Name |Operation|Operand 


(name)|RECORD 

I 
I 


|riDENT=(length,*name', 

|L input-location)J 

||~F IE LD= (length,(input- 
j location),[conversion) 

| \j f [output-location)). . ._ 


IDENT=(1ength,•na me',input-1ocation) 

identifies the last record of the 
record group to which the FIELD param¬ 
eters apply. 

If IDENT is omitted, record processing 
halts after the last record. 


input-location : specifies the starting 
byte of the field to be processed. If 
an input location is not specified, 1 
is assumed. 

conversion : specifies a 2-byte code 

that indicates the type of conversion 
to be performed on this field before 
it is printed, as follows: 

r- T - T -1 

| | |Output Lengthj 

j (Input Length j 

jCode| Conversion | is L) 

h- + - + -^ 

| PZ (Packed to unpack-J 2L-1 | 

j j ed decimal mode j 
| XE jFrom alphameric j 2L j 

j to hexadecimal j | 

J j representation j | 

i-x-x-j 


If conversion is not specified, the 
field will be moved to the output area 
without change. 


output-location : specifies the start¬ 
ing location of this field in the 
output records. If an output location 
is not specified. 

Unspecified fields 
records appear as 
output. 


1 is assumed, 
in the output 
blanks on printed 
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Examples 


Figure 11 illustrates the statements used to print 30 logical records from a 
sequential data set. The printed output will be titled THIS IS A SAMPLE, beginning in 
position 10. The input data will be printed in hexadecimal representation. 

Figure 12 illustrates the statements used to punch a partitioned data set. The output 
will be titled THIS IS A COMPLETE PDS. The initial card sequence number will be 30 with 
an increment of five. Two exit routines, INEXIT and OUTEXIT, are used. Bytes 1 to 8 of 
the input records will appear in columns 10 through 17 of the punched output, and bytes 9 
through 38 will be printed in hexadecimal representation and placed in columns 20 throuqh 
79. 


r 

1 


Sample Coding Form 

\//PRINT 

JOB 

09-660,D.P.BROWN 

|// 

EXEC 

PGM=IEBPTPCH 

I//SYSPRINT DD 

SYSOUT=A 

|//SYSUT1 

DD 

(Parameters defining the input data set.) 

| //SYSUT2 

DD 

(Parameters defining the printed output data set.) 

| //SYSIN 

DD 

* 

1 

PRINT 

TYPORG=PS,TOTCONV=XE,STOPAFT=30 

1 

TITLE 

ITEM=(" THIS IS A SAMPLE" ,10) 


!-!_i 

Figure 11. Printing Records From a Sequential Data Set 





Sample Coding Form 


| //PUNCH 

JOB 

|// 

EXEC 

1 //SYSPRINT DD 

| //SYSOT1 

DD 

j//SYSUT2 

DD 

| //SYSIN 

DD 

1 

1 

PUNCH 

1 

1 

J 

TITLE 

1 

EXITS 

1 

|/* 

RECORD 

L 

_—_ 


09-660,D.P.BROWN 
PGM=IEBPTPCH 
SYSOUT=A 

(Parameters defining the input data set.) 
(Parameters defining the punched output data set.) 

* 

TYPORG=PO,,CNTRL=2„ CDSEQ=30,CDINCR=5„ 

MAXGPS=1,MAXFLDS=2 

ITEM=(" THIS IS A COMPLETE PDS\,5) 

INREC=INEXIT,OUTREC=OUTEXIT 
FIELD= ( 8, 1, , 10 ) „ FIELD= (30,, 9-, XE , 2 0) 


Figure 12. Punching a Complete Partitioned Data Set 



* 


* 
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UPDATING SYMBOLIC LIBRARIES 


The IEBUPDAT utility program incorporates both IBM- and user-generated source language 
modifications into symbolic libraries. (A symbolic library is a partitioned data set 
containing 80-byte records, such as SYS1.PROCLIB, and SYSl.MACLIB.) It is executed or 
invoked with the symbolic name IEBUPDAT. The program can: 

• Add, copy, and replace members. 

• Add, delete, replace, and renumber the records within an existing member. 

• Assign sequence numbers to the records of a new member. 

The IEBUPDAT program uses two input data sets. A DD statement named SYSUT1 defines an 
old-master partitioned data set. The DD statement named SYSIN defines a sequential data 
set containing all of the transactions that are to be applied to the old master. 

IEBUPDAT also uses two output data sets. A DD statement named SYSUT2 defines a 
new-master partitioned data set. The DD statement named SYSPRINT defines a sequential 
data set that reflects either the latest changes applied to the old master or the entire 
new master. 

The input data sets defined by SYSIN and SYSUT1 and the output data set defined by 
SYSUT2 can contain either blocked or unblocked records with a logical record length of 80 
bytes. The output data set can have a blocking factor different from the input data 
sets. 

Notes: If the DD statements SYSUT1 and SYSUT2 define the same data set, the user can 

make modifications to the old master without creating a new master. 

If enough space cannot be allocated for reblocked output records, the update request 
will be terminated. 


EXEC Statement Control Information 

The IEBUPDAT program obtains control 
information through the EXEC statement and 

the SYSIN data set. The EXEC statement for 
this program should contain the parameter: 

r- 1 

| PARM=(input,inhdr,intlr) | 

input : specifies either NEW or MOD, as 
follows: 

r- t- 1 

| Input | Meaning | 

y - + --I 

| NEW | The input consists of the | 

j SYSIN data set.* j 

| MOD j The input consists of both j 

| the SYSIN and SYSUT1 data j 


j j sets. | 

h-X-1 

|* Note: The SYSUTl data set need not| 
|be defined if NEW is specified. j 

L_ 


If the input is any other value, an 
error is indicated and the operation 
terminated. If an input is not speci¬ 
fied, MOD is assumed. 

inhdr: specifies the symbolic name of 
a routine that processes the user 
header label on the SYSIN data set. 


intlr : specifies the symbolic name of 

a routine that processes the user 
trailer label on the SYSIN data set. 

If a value is omitted from the PARM 
field, its absence must be indicated 
by a comma (e.g., PARM=(input,,intlr). 

All other control information needed to 
execute the IEBUPDAT program is entered 
through the SYSIN data set. This informa¬ 
tion is supplied on a header statement and 
one or more detail statements and ALIAS 
statements. An ENDUP statement can be used 
to indicate the end of the SYSIN input to 
this program. Figure 13 illustrates the 
order of the SYSIN control statements. 

r - 1 

i -- i 

if END UP statement (optional) 

/I..... . . 

IALIAS statements _ 


(Detail statements _ 

(Header statement | 

I I 

L-J 

Figure 13. SYSIN .Control Statements 

The SYSIN data set can contain any number 
of header statements, each followed by a 
group of detail statements and ALIAS state¬ 
ments . 
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Header Statement 


1 


A header statement must be provided for 
each member to be processed. The state¬ 
ments must be in binary collating sequence 
by member name. The header statement con¬ 
tains : 


| Columns| Contents j 

j.- + -^ 

j 1-2 j Period-slash (./) j 

| 10 | / ADD 

j | I REPL j 

j j | CHNGE j 

j \ REPRO i 

j 16 j itiembername, level, 

| j source,, list , ssi j 

l -x-j 


ADD : indicates that the named member 
is to be added in its entirety to the 
new master. 

REPL : indicates that the named member 
is being entered in its entirety as a 
replacement for a member in the old 
master. 

CHNGE : indicates that modifications 
are to be made within the named mem¬ 
ber . 

REPRO : indicates that the entire named 
member is to be copied onto the new 
master. Members are deleted from a 
library by being omitted from a series 
of REPRO operations. 


The following parameters,, separated by 
commas,, are written beginning in column 16. 

membername : specifies the name of the 
member to which the update transac¬ 
tions are to be applied. 

level : specifies the current run num¬ 
ber, a 2-digit number from 00 to 99. 

source : specifies either 0 or 1, as 

follows: 

0 - indicates user modifications. 

1 - indicates IBM modifications. 

list: specifies either 0 or 1* as 
follows: 

0 - indicates that the SYSPRINT 
data set is to contain only 
modifications and control 
statements,. 


- indicates that the SYSPRINT 
data set is to contain the 
entire updated member and con¬ 
trol statements. 


ssi: specifies eight bytes of new 
system status index information that 
is to be placed in the directory of 
the new master as the first four 
hexadecimal bytes of user data. If 
ssi information is not specified, the 
user data is copied as it exists in 
the directory of the old master. Sys¬ 
tem status index information is dis¬ 
cussed in detail in the publication 
IBM System/360 Operating System: Main¬ 
tenance ,, Form C27-6918. 


Detail Statements 


The detail statements contain informa¬ 
tion to be applied to the member that is 
named in the header statement. These 
statements and their formats are discussed 
in the following paragraphs. 

The NUMBR statement is used with CHNGE 
operations to change the sequence number of 
one or more logical records within a mem¬ 
ber, and with ADD and REPL operations to 
assign sequence numbers to the records 
within new and replacing members. This 
statement affects only those sequence num¬ 
bers that fall in the specified range. A 
NUMBR statement contains: 


j Columns j 

t-+- 

1-2 
10-14 
16-23 


Contents 


24 

25-32 


33 

34-41 

42 

43-50 


A period-slash (./). 

NUMBR 

The sequence number of the 
first record to be renumbered 
in CHNGE operations,. This 
field is ignored in ADD and 
REPL operations. 

A comma („). 

The sequence number of the last 
record to be renumbered in 
CHNGE operations. This field 
is ignored in ADD and REPL 
operations. 

A comma (,). 

The first new sequence number. 
A comma („ ) . 

The increment value of succes¬ 
sive new sequence numbers. 


Note: All of the sequence numbers must 

be 8 digit,, alphameric fields. 
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The DELET statement is used to delete 
one or more logical records within a mem¬ 
ber. It is used only in conjunction with a 
CHNGE header statement. A DELET statement 
contains: 


r- t~ 

|Columns| 

I*-+- 


Contents 



1 

1-2 

i 

A period-slash 

(./) . 




1 

10-14 

i 

DELET 




* 

1 

16-23 

i 

The sequence 

number 

of 

the 


1 

1 


i 

i 

first logical 
deleted. 

record 

to 

be 


1 

24 

i 

A comma (, ) . 




* 

1 

25-32 

i 

The sequence number of 

the 

last 


1 


i 

logical record 

to be deleted. 


l_ jl _ 


_j 


ALIAS Statements 


The ALIAS statements create or retain 
aliases in the new master directory. They 
can be used in conjunction with any of the 
header statements. One ALIAS statement 
must be supplied for each alias. It con¬ 
tains : 

r- t-1 

|Columns| Contents 

j.-1-^ 

| 1-2 | A period-slash (./). 

j 10-14 j ALIAS 

| 16 j An alias name. 

L - JL -j 

Note: If provided, system status index 

information for the member name is also 
inserted into the alias entry in the direc¬ 
tory of the new master. 


The logical record statements contain 
the data to be added to, or used to 
replace* existing logical records. They 
are used in conjunction with ADD* REPL, or 
CHNGE header statements. The logical 
record statements contain: 


r—- t- 1 

|Columns| Contents | 

(.-1--| 

| 1-72 | The data to be added or used as | 

j j a replacement. 

| 73-80 j The sequence number of the | 

j \ record. 

l -r-j 


ENDUP Statement (optional) 


The ENDUP statement can be used to 

indicate the end of the SYSIN input to this 
program; it serves as an end-of-data indi¬ 
cation if there is no other indication. 

The ENDUP statement follows the last group 
of SYSIN control statements and contains: 

r- - - 1 

|Columns| Contents 

f-+-^ 

| 1-2 | A period-slash (./). j 

j 10-14 j ENDUP 


* 
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Examples 


Figure 14 illustrates the cataloging of a set of job control statements in the 
cataloged procedure library, PROC6 will be added to the cataloged procedure library 
defined in both SYSUT1 and SYSUT2. The first record of this procedure will contain the 
sequence number 00000010 with successive records numbered 00000020* 00000030*,... The 
resulting cataloged procedure can be executed with an EXEC statement specifying 
PROC=PROC 6• 

Figure 15 illustrates the replacement of a member in the old master by a new member. 
In this example* MBR7 (alias ALS7) will replace MBR7 of the library named in SYSUT1. 
Successive records in the new member will contain the sequence numbers 00000010* 
00000020 *.... 

Figure 16 illustrates the deletion of logical records 00000050 through 00000090 from a 
member of a symbolic library. 

Figure 17 illustrates the copying of a member from the old master onto the new master. 

Figure 18 illustrates the creation of a three-member library- The members are named 
LIBMEMB1* LIBMEMB2* and LIBMEMB3• 


Sample Coding Form 


1-- 

//UPD1 

JOB 

09-770*D.P.BROWN 

■ ~ 


—^ 

I// 

EXEC 

PGM=IEBUPDAT* PARM=MOD 




I//SYSPRINT DD 

SYSOUT=A 




j//SYSOTl 

DD 

(Parameters defining the cataloged 

procedure 

library.) 


|//SYSUT2 

DD 

(Parameters defining the cataloged 

procedure 

library.) 


//SYSIN 

DD 

DATA 




|./ 

ADD 

PROC6, 05,0,1 




1 •/ 

NUMBR 

00000000,00000000,00000010,00000010 




|//JOBX 

JOB 

— 




|//STEP1 

EXEC 

— 




|//DD1 

1 

DD 

— — — 




1 

j//STEP2 

1 

EXEC 

— 




1 

|/* 

L_ x ..... -i . 

• 




j 

Figure 14 

. Cataloging Job Control Statements in the 

Cataloged Procedure Library 


r 

1 


Sample Coding Form 


i 

L - 



— 

— 

- 4 


//UPD2 

JOB 

I// 

EXEC 

j//SYSPRINT DD 

| //SYSUTl 

DD 

j//SYSUT2 

DD 

|//SYSIN 

DD 

1 •/ 

REPL ] 

1 •/ 

NUMBR 

j Logical : 

i 

N * 1 
• S J 

ALIAS . 


09-770*D.P.BROWN 
PGM=IEBUPDAT*PARM=MOD 
SYSOUT=A 

(Parameters defining the old master data set.) 
(Parameters defining the new master data set.) 

* 

MBR1* 0 6*0 *1 


Figure 15. Replacing a Member of a Symbolic Library 
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Sample Coding Form 


j//UPD3 

JOB 

09-770„D.P.BROWN 





|// 

EXEC 

PGM=IEBUPDAT 





|//SYSPRINT DD 

SYSOUT=A 





|//SYSUT1 

DD 

(Parameters defining 

the 

old master 

data 

set.) 

j//SYSOT2 

DD 

(Parameters defining 

the 

new master 

data 

set.) 

I//SYSIN 

DD 







j./ CHNGE MBRS,13„0 f ,l 

(./ DELET 00000050,00000090 

|./ ALIAS ALS5 

j/* _ 

Figure 16. Deleting a Record From a Symbolic Library 


Sample Coding Form 


I//UPD 4 JOB 09-770,,D.P.BROWN 

j // EXEC PGM= IEBUPDAT,, PARM=MOD 

j//SYSPRINT DD SYSOUT=A 

j//SYSUT1 DD (Parameters defining the old master data set.) 

I//SYSUT2 DD (Parameters defining the new master data set.) 

|//SYSIN DD * 

j./ REPRO MBRZ,12„0„1 

\ / * 

l - 


Figure 17. Copying a Member of a Symbolic Library 


I Sample Coding Form 


//UPD5 

JOB 

09-770,, D. P. BROWN 


EXEC 

PGM= IEBUPDAT,, PARM=NEW 

//SYSPRINT 

DD 

SYSOUT=A 

//SYSUT2 

DD 

(Parameters for creating a master data set) 

//SYSIN 

DD 

* 


./ ADD LIBMEMB1* 01„ 0„ 1„ 1234ABCD 

Logical Record Statements 


• / ADD LIBMEMB2* 01,0,1„ 1234EFGH 

Logical Record Statements 

./ ADD LIBMEMB3,01„ 0,1,, 1234JKLM 

Logical Record Statements 


/* 


Figure 18. Creating a Three Member Library 
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SECTION 3: 


INDEPENDENT UTILITIES 



* 


* 


* 



Independent utility programs operate 
outside, and in support, of the IBM 
System/360 Operating System. They include: 

• DASDI — a program that initializes and 
assigns alternate tracks to a direct- 
access volume. 

• DUMP/RESTORE — a program that dumps 
and restores the data contents of a 
direct-access volume- 


Operating Procedure 


Independent utility programs are loaded 
as card decks or as card images on tape. 
Control statements for the requested 
program can follow the last card or card 
image of the program, or can be entered on 
a separate input device. To execute DASDI 
or DUMP/RESTORE: 


Utility Control Statement Requirements 


Independent utility programs require a 
JOB statement, a MSG statement, a group of 
statements that describe the function to be 
performed, and an END statement. 

The JOB statement indicates the 
beginning of a job. 

r- t r i 

|Name |Operation|Operand 


j[name]jJOB j[user information] 

L_J.-X-J 


1. Place the object program deck in the 
reader or mount the tape reel that 
contains the object program. 


2. Load the object program from the read¬ 
er or tape drive by setting the load 
selector switches and depressing the 
console LOAD key. When the program is 
loaded, the wait state is entered and 
the console lights display the hexa¬ 
decimal value FFFF. 


3. Define the control statement input 
device in one of the following two 
manners: 


The MSG statement defines an output 
device for operator messages. It follows 
the JOB statement and precedes a group of 
function-defining statements that are asso¬ 
ciated with one of the independent utility 
programs. 

I-T-T- 1 

|Name |Operation|Operand 

h- + -+-j 

|[name]|MSG jTODEV=xxxx | 

j | |TOADDR=cuu j 

L_x-x-J 

TODEV=xxxx 

specifies the device type of the mes¬ 
sage output device. 

TO ADD R= cuu 

specifies the channel number (c) and 
unit number (uu) of the message output 
device. 

The END statement denotes the end of 
job. It appears after the last function¬ 
defining statement. 

r- t-t-1 

|Name |Operation|Operand | 


j[name]jEND j [user information] | 

l _x_x-J 


a. Depress the REQUEST key of the 
console typewriter. The message 
DEFINE INPUT DEVICE is printed. 
Enter the following message from 
the console typewriter: 

INPUT=xxxx cuu 

where xxxx is the device type, c 
is the channel address, and uu is 
the unit address. The device type 
can be 1402, 1442, 2400, or 2540. 

b. (Use only if the console typewrit¬ 
er is not available.) Enter one 
of the following numbers at stor¬ 
age location 0110 (hexadecimal): 

lcuu for a 1442 Card Read Punch. 
2cuu for a 2400 Nine-Track Mag¬ 
netic Tape Drive. 

Ocuu for a 2540 Card Read Punch. 

Depress the console INTERRUPT key 
and the START key. 


4. Control statements are printed on the 
message output device. At the end of 
the job, END OF JOB is printed on the 
message output device and the program 
enters the wait state. 


Section 3: Independent Utilities 
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INITIALIZING AND ASSIGNING ALTERNATE TRACKS ON DIRECT-ACCESS VOLUMES 


The DASDI independent utility program performs two separate functions: it initializes 
direct-access volumes for use with the operation system, and assigns alternate tracks on 
disk storage volumes. A single job can initialize one volume or assign alternates for 
specified tracks on one volume. DASDI jobs can be performed continuously by stacking 
complete sets of control statements. The last job is followed by an END statement and 
should not be followed by any other control statement. 


INITIALIZING A DIRECT-ACCESS VOLUME 


The first function of the DASDI program 
is used to initialize a disk storage volume 
as follows: 

• Writes standard home address and track 
descriptor records. 

• Checks for bad tracks and automatically 
assigns alternates, if necessary (disk 
storage volumes, only). 

• Writes IPL records on track zero 
(records 1 and 2). 

• Writes initial volume label (record 3) 
and provides space for additional 
labels, if requested. 

• Writes volume table of contents (VTOC). 

• Erases the remainder of each track. 

• Writes IPL program, if requested. 

The DASDI program requires the following 
function-defining statements to initialize 
direct-access volumes: 

1. DADEF Statement. 

2. VLD Statement. 

3. VTOCD Statement. 

4. IPLTXT Statement (optional). 

These statements must appear in this 
sequence. Continued control statements are 
not printed on the message output device. 


DADEF Statement 


The DADEF statement defines the direct- 
access volume to be initialized. 


TOADDR=cuu 

specifies channel number (c) and unit 
number (uu) of the device. 

IPL=YES 

specifies that an IPL program is to be 
written on the volume. An IPL ini¬ 
tialization program must be written on 
a device to be used for system resi¬ 
dence. 

If IPL is omitted, an IPL program is 
not written. 

VOLID=serial 

specifies the volume serial number of 
the volume to be initialized. 

If "serial" matches the volume serial 
number found on the volume to be 
initialized, the operation proceeds. 
If it does not match, the operator is 
notified. 

VOLID=SCRATCH 

specifies that no volume serial number 
check is to be made. 

If VOLID is not specified and the 
volume to be initialized contains a 
volume serial number, the operator is 
notified. 


VLD Statement 


The VLD statement contains information 
for constructing an initial volume label 
and allocating space for additional labels. 


r t t - 

[Name |Operation|Operand 

i i 

1 

J 

r 

1 

r t 

| [name]|DADEF 

1 1 

i 
i 

i i 

L JL 

T 

|TODEV=xxxx 
j TOADDR= CUU 
|[IPL=YES] 
j [VOLID=serial "1 

|Lvolid=scratch J 

J 

f 

L 


- T - T - 

Name |Operation|Operand 

- + - + - — 

[name]jVLD j NEWVOLID=serial 

j j|VOLPASS= 1] 

| j1 VOLPASS=Q 

j |[OWNERID=xxxxxxxxxx] 

j [ADDLABEL=n] 


TODEV=xxxx 

specifies the device type of the 
direct-access device. 


NEWVOLID=serial 

specifies a 6-character volume serial 
number. 
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VOLPASS=l 

specifies that the volume security bit 
is to be set to 1. 


VOLPASS=0 

specifies that the volume security bit 
is to be set to 0. 


If VOLPASS is omitted, the volume 
security bit will be set to 0. 


OWNERID= xxxxxxxxxx 

specifies a 1- to 10-character field 
that identifies the owner of the vol¬ 
ume. 


If OWNERID is omitted, no identifi¬ 
cation is given. 

ADDLABEL=n 

specifies a number between one and 
seven that indicates the total number 
of additional labels for which space 
is to be allocated. 

If ADDLABEL is omitted, 0 is assumed. 


VTOCD Statement 


The VTOCD statement contains information 
for controlling the location of the volume 
table of contents. 


r t ~ t — i 

|Name |Operation|Operand | 

t- + -+-1 

j[name]jVTOCD |STRTADR=nnnnn | 

IEXTENT=nnnn j 

L_ ± _X-J 

STRTADR= nnnnn 

specifies the 1- to 5-byte track 
address, relative to the beginning of 
the volume, at which the volume table 
of contents is to begin. The VTOC 
cannot occupy track 00 or any alter¬ 
nate track. 

EXTENT=nnnn 

specifies the length of the volume 
table of contents in tracks. The 
number of entries per track for each 
type of device is given below. 

Device VTOC Entries/Track 

2311 16 

2302 22 


IPLTXT Statement 


The IPLTXT statement separates utility 
control statements from IPL program text 
statements. It is required only when IPL 
text is included. The statement consists 
of the operation IPLTXT, followed with 
blanks. 

When IPL text is included, the END 
statement must contain the operation END in 
columns 2 to 4. 


Example 


Figure 19 illustrates the initialization of an IBM 2311 disk storage volume for later 
use as a system residence volume. An IPL program is included as a load module in 
standard TXT format. 


Sample Coding Form 


INIT 


TXT 


TXT 

END 


JOB •INITIALIZE 2311* 

MSG TODEV=1403,TOADDR= 0 0E 

DADEF TODEV= 2311,TOADDR=108,IPL=YES 

VLD NEWVOLID=Pl,OWNERID=BROWN, 

AD DLABEL=2 

VTOCD STRTADR=1,EXTENT^ 9 
IPLTXT 


IPL Program 


COMMENTS 
MESSAGE OUTPUT 
VOLUME DEFINITION 
VOLUME LABEL 
DEFINITION 
VTOC DEFINITION 
DELIMITER 
IPL PROGRAM 


Figure 19. Initializing a Direct-Access Volume 
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ASSIGNING AN ALTERNATE TRACK 


The second function of the DASDI program 
is used specifically to assign alternate 
tracks on a disk storage volume. Before an 
alternate is assigned, the track in ques¬ 
tion is checked. If it is found to be bad, 
an alternate is assigned and the address 
made known to the operator. 

If the track in question is already 
assigned as an alternate, a new alternate 
is assigned. If the track in question is 
an unassigned alternate,, it is flagged to 
prevent its future use. 


GETALT Statement 


TODEV= xxxx 

specifies the device type of the 
direct-access device. 

TOADDR=cuu 

specifies the channel number (c) and 
unit number (uu) of the direct-access 
device. 


TRACK=cccchhhh 

specifies address of the track for 
which an alternate is requested, where 
cccc is the cylinder number and hhhh 
is the head number. 


BYPASS=YES 

specifies that the program*s bad-track 
checking feature is to be bypassed. 


Any number of alternate tracks on a 
volume can be assigned in a single job by 
including one GETALT statement for each 
track. 


T 

Name |Operation 

I 

T “ 

|Operand 

1 

1 

1 

T 

[name]j GETALT 

| 

j TODEV=xxxx 

1 

1 

j TOADDR=CUU 


1 

1 

j TRACK=cccchhhh 
j[BYPASS=YES] 
j VOLID=serial 

J 


If BYPASS is omitted, the program 
assigns an alternate only if it finds 
that the specified track is bad. 


VOLID=serial 

specifies the volume serial number of 
the volume to which an alternate track 
is to be assigned. 

If "serial" matches the volume serial 
number found on this volume,, the 
alternate track assignment proceeds. 
If it does not match, the operator is 
notified. 


Example 


Figure 20 illustrates the assignment of three alternate tracks to a disk storage 
volume,, without re-initialization of the volume. The program's bad-track checking 
feature is bypassed when the first two of the three tracks are assigned. 


Sample Coding Form j 


| ALTRK 

1 

ISTMT1 

JOB 

MSG 

GETALT 

•ASSIGN ALTERNATE TRACKS ON 2311 J COMMENTS 
TODEV=2400,TOADDR=180 MESSAGE OUTPUT 

TODEV= 2311,TOADDR=190,TRACK= 006F0001, 

C 


i 

1 

|STMT2 

GETALT 

B YPASS=YES,, VOLID=P2 

TODEV= 2311,TOADDR=l90, TRACK= 00910004 , 

C 



1 

|STMT3 

GETALT 

BYPASS=YES„VOLID=P2 

TODEV=2 311, TOADDR=l90 , TRACK—004B0007,, 

C 



1 

1 

L 

END 

VOLID=P2 


J 

• 


Figure 20. Assigning Alternate Tracks on a Disk Storage Volume 
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DUMPING AND RESTORING A DIRECT-ACCESS VOLUME 


The DUMP/RESTORE program dumps and restores the data on direct-access volumes. The 
data contents of a direct-access volume Call data except the home address) can be 
"dumped" onto an IBM 2311 disk storage volume or a magnetic tape, and restored onto a 
direct-access volume that resides on the same type of device as the source volume. Both 
the source volume and the volume onto which data is to be restored must have been 
initialized to IBM System/360 Operating System specifications. This utility is useful 
for preparing transportable copies and backup copies of direct-access volume contents. 


DUMP Statement 


The DUMP statement is used to identify 
both the source volume whose contents are 
to be dumped and the receiving volume. The 
data contents of the entire source volume 
is dumped, including any data on alternate 
tracks. If both the source and receiving 
volumes reside on 2311 Disk Storage Drives, 
the data on the receiving volume is an 
exact replica of the source data and need 
not be restored. 


If "serial" matches the volume serial 
number found on the receiving volume, 
the dump operation proceeds. If it 
does not match, the operator is noti¬ 
fied. 


If VOLID is not specified and the 
receiving volume contains a volume 
serial number, the operator is simi¬ 
larly notified. 


~T-T- 

|Operation|Operand 


I Name 


Y - + - 

- + - 

—i 

|[name](DUMP 

|FROMDEV=xxxx 

1 i 

|FROMADDR=cuu 


1 

|TODEV=xxxx 


1 1 

j TOADDR=cuu 


1 1 

|[VOLID=serial-list] 


Li. 


-j 


VDRL Statement 


The VDRL (volume dump/restore limits) 
statement is used to specify the upper and 
lower limits of a partial dump. If a track 
within these limits has had an alternate 
assigned to it, the data on the alternate 
track is included in the dump. When the 
VDRL statement is used, it must be preceded 
by a DUMP statement and must be followed by 
an END statement. 


FROMDEV= xxxx 

specifies the device type of the 
source device. 

FROMADDR=cuu 

specifies channel number (c) and unit 
number (uu) of the source device. 

TODEV=xxxx 

specifies the device type of the 
receiving device. 

TOADDR=cuu 

specifies the channel number (c) and 
unit number (uu) of the receiving 
device. 

VOLID=serial(,serial]... 

specifies the volume serials of the 
receiving volumes onto which data is 
to be dumped. (VOLID is required when 
the receiving volume has been initial¬ 
ized to operating system specifi¬ 
cations .) 


1 Name |Operation|Operand 

i 

i 

i i 

|[name]|VDRL 

|BEGIN=nnnnn 

1 

| 

i i 

j[END=nnnnn] 

| 



j 


BEGIN=nnnnn 

specifies a 1- to 5-byte relative 
track address that identifies the 
first track to be dumped. 

END=nnnnn 

specifies the relative track address 
of the last track to be dumped. If 
only one track is to be dumped, this 
address is the same as the beginning 
address. 

If END is omitted, the last track of 
the volume, excluding those tracks 
reserved as alternates, is assumed to 
be the upper limit. 
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RESTORE Statement 


The RESTORE statement is used to iden¬ 
tify both the source volume whose data 
contents are to be restored and the receiv¬ 
ing volume. 


| Name j Operation|Operand j 

I*-+-+--1 


j [name]j RESTORE |FROMDEV=xxxx 
| | jFROMADDR=CUU | 

j TODEV=xxxx | 

| | |TOADDR=cuu 

| | |VOLID=serial j 

L _ X --L-J 


FROMDEV= xxxx 

specifies the device type of the 
source device. 


FROMADDR=CUU 

specifies the channel number (c) and 
unit number (uu) of the source device. 


TODEV=xxxx 

specifies the device type of the 
receiving device. This device type 
must be the same as the device con¬ 
taining the volume originally dumped. 

TOAD D R=c uu 

specifies the channel number (c) and 
unit number (uu) of the receiving 
device. 

VOLID=serial 

specifies the volume serial number of 
the receiving volume. 

If "serial" matches the volume serial 
number found on the receiving volume, 
the restore operation proceeds. If it 
does not match, the operator is noti¬ 
fied. 


Examples 


Figure 21 illustrates the dumping of a direct-access volume onto a tape volume. 
Figure 22 illustrates the restoring of dumped data onto a direct-access volume. 


\ 

Sample Codipg 

Form 


- *» 

1 

4 

f - 

| DUMP 

JOB DUMP 2311 ONTO TAPE 

MSG TODEV=1052,TOADDR=103 

DUMP FROMDEV=2 311,FROMADDR= 2 0 3, 

TODEV= 2400,TOADDR=12 0 

END 

COMMENTS 

MESSAGE OUTPUT 

C 

i 

J 

Figure 21 

• Dumping a Direct-Access Volume 




r 

Sample Coding 

Form 


1 

l 

4 

RESTORE 

JOB RESTORE 2311 FROM TAPE 

MSG TODEV=1052, TOADDR=10B 

RESTORE FROMDEV=2400,FROMADDR=l20,TODEV= 2311, 

T OADDR=2 0 2„VOLID=PZ 

END 

C 

| 

1 

1 

1 

1 

1 


Figure 22. Restoring a Direct-Access Volume 
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APPENDIX A: EXIT ROUTINE LINKAGE 


Linking to an Exit: Routine 


Data set utility programs perform link¬ 
age operations by using the LINK macro¬ 
instruction. This macro-instruction 

contains the symbolic name of the entry 
point to an exit routine and, if required, 
a list of parameters. Table 4 shows the 
ordered parameter list for each available 
exit. (Format and contents of the DCB are 
presented in the publication IBM System/360 
Operating System: Control Program Services , 
Form C28-6541.) 

At the time of the linkage operation: 

• General register 1 contains the start¬ 
ing address of the parameter list. 


• General 

register 

13 

contains 

the 

address 

of the register 

save area. 


• General 

register 

14 

contains 

the 

address 

of the 

return 

point in 

the 

utility 

program. 




• General 

register 

15 

contains 

the 

address 

of the entry point to the 

exit 


routine. 


Registers 1 through 14 must be restored to 
these values before control is returned to 
the utility program. 


The exit routine must be contained in 
either the job library or the link library. 


Table 4. Parameter Lists for Exit Routines 


Program 


Exit 


Parameters (In Order of Appearance in Parameter List) 


COPYPDS 


None 


GENERATE 


INHDR 

OUTHDR 

INTLR 

OUTLR 

KEY 

DATA 

IOERROR 


H 


Address of input header label; address of DCB. 

Address at which user output label is to be created; address of 
DCB. 

Address of input trailer label; address of DCB. 

Address at which user output trailer label is to be created; 
address of DCB. 

Address at which key is to be placed (record follows key); address 
of DCB. 

Address of SYSUT1 record; address of DCB. 

Address of DECB; cause of the error and address of DCB (packed 
word ). ± 




COMPARE 


INHDR 

INTLR 

ERROR 

PRECOMP 


^ PRINT/PUNCH 


Address of input header label; address of DCB. 

Address of input trailer label; address of DCB. 

Address of DCB for SYSUT1; address of DCB for SYSUT2• 2 
Address of SYSUT1 record; length of SYSUT1 record, address of 
SYSUT2 record; length of SYSUT2 record. 


H 


INTLR 

OUTLR 

INREC 

OUTREC 


h 


Address of input header label; address of DCB. 
Address of input trailer label; address of DCB. 
Address of input record; length of input record. 
Address of output record; length of output record. 


UPDATE 


inhdr 

intlr 


Address of input header label for SYSIN data set; address of DCB. 
Address of input trailer label for SYSIN data set; address of DCB. 


*-For the packed-word format of this parameter, refer to the CHECK macro-instruction, 
discussed in the publication IBM System/360 Operating System: Control Program 
Services . 

2 The IOBAD pointer in the DCB points to a location that contains the address of the 
corresponding data event control block (DECB) for these records. The format of the 
DECB is illustrated as part of the BSAM READ macro-instruction in the publication 
IBM System/360 Operating System: Control Program Services . 


Appendix A: Exit Routine Linkage 
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Returning From an Exit Routine 


An exit routine returns control to the 
utility program by means of the RETURN 
macro-instruction in the exit routine. 


r -r- t- 1 

|Name |Operation|Operand 

J.-+-+-^ 

| [name](RETURN |((r ± ,,r 2 )] j 

I I I pc=n I | 

| | |LrC=(15)J | 

l-X-X- J 

(r ± ,r 2 ) 

specifies the range of registers to be 
reloaded by the utility program from 
the register save area. 

If this parameter is omitted, the 
registers are considered properly 
restored by the exit routine. 


RC=n 

specifies a return code to be placed 
in the 12 low-order bits of general 
register 15. 

RC=(15) 

specifies that general register 15 
already contains a valid return code. 

If RC is omitted, register 15 is 
loaded as specified by (r ± ,r 2 ). 


The utility programs examine the return 
code and respond as described in Table 5. 
Further information on the use of the LINK 
and RETURN macro-instructions and exit rou¬ 
tine linkage is contained in the publica¬ 
tion IBM System/360 Operating System: Con¬ 
trol Program Services . 


Table 5. Action on Return Codes 
r~ 

I 

h 


Type of Exit 


All other exits 


Label processing exits 


r - 

i 

-+- 


Return Code 


Action 


16 


0,4 


Return code is passed to the 
OPEN routine. 

Utility program is terminated. 


Any other number 


0-11 

(Set to next lowest 
multiple of 4, 
i.e., 0,, 4, 8) 


12-16 

(Set to either 
12 or 16) 


Return code is passed to the 
OPEN routine. 


Return code is compared to 
highest previous return code; the 
higher is saved and the other 
discarded. At the normal end of 
job, the highest return code is 
passed to the calling processor. 




Utility program is terminated 
and this return code is passed 
to the calling processor. 
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APPENDIX B: INVOKING UTILITY PROGRAMS 


Utility programs can be invoked by a 
problem program through the use of the 
ATTACH or LINK macro-instructions. 

The problem program must supply to the 
utility program: 

• The information usually specified in 
the PARM parameter of the EXEC state¬ 
ment . 


The option list must begin on a half¬ 
word boundary (one that is not also a 
full-word boundary). The two high- 
order bytes contain a count of the 
number of bytes in the remainder of 
the list, (For all programs except 
IEBUPDAT, the count must be zero.) 
The option list is free form with each 
field separated by a comma. No blanks 
or zeros should appear in the list. 


• The ddnames of the data sets to be used 
during processing by the utility pro¬ 
gram. 
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| Name 

h- 

| [name] 
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j Operation|Operand 


jfLINK I j EP=progname 
|t ATTACH I I PARAM=(optionaddr 

j (,ddnameaddr3), VL=1 
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I 

I 
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EP=progname 

specifies the symbolic name of the 
utility program. 


PARAM 

specifies, as a sublist, address pa¬ 
rameters to be passed from the problem 
program to the utility program. The 
first full-word in the address parame¬ 
ter list contains the address of 
information that is usually specified 
in the PARM parameter of the EXEC 
statement. The second full-word con¬ 
tains the address of the ddname list. 

If standard ddnames are to be used, 
the second full word can be omitted. 

optionaddr 

specifies the address of a variable 
length list containing information 
usually specified in the PARM parame¬ 
ter of the EXEC statement. This 
address must be written for all utili¬ 
ty programs even though IEBUPDAT is 
the only program that requires PARM 
inf ormation. 


ddnameaddr 

specifies the address of a variable 
length list containing alternate 
ddnames for the data sets used during 
utility program processing. If stan¬ 
dard ddnames are used, this operand 
may be omitted. 

The ddname list must begin on a half¬ 
word boundary (one that is not also a 
full-word boundary). The two high- 
order bytes contain a count of the 
number of bytes in the remainder of 
the list. Each name of less than 
eight bytes must be left justified and 
padded with blanks. If an alternate 
ddname is omitted from the list, the 
standard name is assumed. If the name 
is omitted within the list, the 8-byte 
entry must contain binary zeros. 
Names can be omitted from the end by 
merely shortening the list. 

The sequence of the 8-byte entries in 
the ddname list is as follows: 


Entry 

1 

2 

3 

4 

5 

6 

7 

8 
9 


Alternate Name 
00000000 
00000000 
00000000 
00000000 
SYS IN 
SYSPRINT 
00000000 
SYSUT1 
SYSUT2 


VL=1 

specifies that the sign bit of the 
last full-word of the address parame¬ 
ter list is to be set to 1. 
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APPENDIX C; SYSTEM UTILITY ERROR MESSAGES 


This appendix, message appendixes in other publications, and the publication IBM 
Svstem/3 60 Operating System: Control Program Messages and Completion — Codes , Form 
C28-6608, are designed so that the user can select the messages applicable to his 
installation and incorporate them in a binder- 


The IEHLIST Program 


IEH101I NO CATALOG ON SPECIFIED VOLUME. 

Explanation: No catalog exists on 
the volume identified in the 
LISTCTLG statement. 

System Action: The request is 
ignored. (The return code is 8.) 


IEH102I THIS VOLUME DOES NOT CONTAIN DATA 
SET XXX. 

Explanation: The data set iden¬ 
tified in the LISTVTOC or LISTPDS 
statement is not contained in the 
specified volume's table of con¬ 
tents. 

System Action: The request is 
ignored. (The return code is 8.) 


IEH103I INVALID CONTROL STATEMENT — xxx. 


Explanation: A utility statement 
is invalid. (The entire statement 
is written.) 


System 

Action: The 

request 

is 

ignored- 

(The return 

code is 

8. ) 

IEH104I THE PDS 

ORGANIZATION 

DOES 

NOT 


APPLY FOR DATA SET xxx. 

Explanation: The data set iden¬ 

tified in the LISTPDS statement is 
not partitioned- 

System Action: The request is 
ignored. (The return code is 8.) 


IEH105I ILLEGAL NODE POINT SPECIFIED, OR 
INCONSISTENT CATALOG STRUCTURE 
FOUND — REQUEST TERMINATED. 

Explanation: The node point iden¬ 
tified in the LISTCTLG statement 
is invalid, or an incorrect cata¬ 
log structure exists. 


System Action: The request is 
ignored. (The return code is 8.) 


IEH106I UNAVAILABLE DEVICE TYPE OR VOLUME 
I.D. SPECIFIED. 

Explanation: The VOL parameter of 

the utility statement is invalid, 
or the volume cannot be mounted. 

System Action: The request is 
ignored. (The return code is 8.) 


IEH107I JOB TERMINATED — I/O ERROR ON 
SYSIN. 

Explanation: Additional input con¬ 
trol statements cannot be read. 

System Action: The job is termi¬ 
nated. (The return code is 16.) 


IEH108I REQUEST TERMINATED — I/C ERROR 
WHILE READING DATA SET. 

Explanation: The user's synchro¬ 

nous error exit was taken while a 
volume table of contents, a cata¬ 
log, or a partitioned data set was 
being read. 

System Action: The job is termi¬ 
nated. (The return code is 16.) 


The IEHPROGM Program 


IEH201I INVALID REQUEST ... STATEMENT 
IGNORED. 

Explanation: The utility statement 
contains an invalid operation. 

System Action: The request is 
ignored. (The return code is 8.) 
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IEH202I 


IEH203I 


IEH204I 


IEH205I 


IEH206I 


IEH207I 


INVALID KEYWORD OR CONTROL STATE¬ 
MENT ERROR, 


Explanation: The utility statement 
contains an invalid keyword in the 
operand field, or information that 
should follow a keyword is absent. 

System Action: The request is 
ignored, (The return code is 8.) 


Explanation: An unusual condition 
occurred during a SCRATCH or 
RENAME operation. The message 
names the data set, identifies the 
volumes on which the data set 
resides, states the action taken 
on each volume, and describes the 
condition. 

System Action: The request is 
ignored. (The return code is 8.) 


CATALOG CANNOT BE LOCATED, OR CON¬ 
TROL VOLUMES ARE CONNECTED TO EACH 
OTHER. 

Explanation: No catalog exists on 
the specified control volume, or 
control volumes are connected 
incorrectly to each other. 

System Action: The request is 
ignored* (The return code is 8.) 


STATUS OF THE REQUESTED TASK CAN¬ 
NOT BE DETERMINED. AN UNDEFINED 
ERROR CODE HAS BEEN ENCOUNTERED. 


IEH208I STATUS OF USERS REQUEST TO SCRATCH 
THE VOLUME TABLE OF CONTENTS_ 

DATA SET NAME ACTION TAKEN REASON 

XXX XXX XXX 


• • • 

END OF SCRATCH VTOC. 

Explanation: An unusual condition 

occurred during a SCRATCH VTOC 
operation. The message names each 
data set, states the action taken, 
and describes the condition. (The 
return code is 8.) 


Explanation: The return code from 

a system macro-instruction is 1EH209I LIST TRUNCATED TO 1 VOLUME FOR 
invalid. SCRATCH VTOC. 


System Action: The request is 
ignored. (The return code is 8.) 


Explanation: More than 1 volume is 
identified in a SCRATCH VTOC 
statement. 


INFORMATION IN CONTROL STATEMENT 
IS (REDUNDANT/NOT SUFFICIENT). 

Explanation: Information on the 
utility statement is either redun¬ 
dant or inadequate. 

IEH210I 

System Action: The request is 
ignored. (The return code is 8.) 


CVOL IS NOT DIRECT-ACCESS. 


System Action: Only the first 
volume in the list is considered. 
(The return code is 8.) 


THE MODEL DATA SET CONTROL BLOCK 
IS NOT AVAILABLE. 

Explanation: The required DSCB for 
a BLDG operation cannot be located 
on the specified volume. 


Explanation: The volume identified 
by CVOL is not on a direct-access 
device. 


System Action: The request is 

ignored. (The return code is 8.) 


System Action: The request is 
ignored. (The return code is 8.) 

IEH211I REQUEST CANNOT BE SERVICED _ 


STATUS OF USERS REQUEST TO 
(SCRATCH/RENAME) DATA SET xxx... 

VOLUME ID ACTION TAKEN REASON 
XXX xxx xxx 


reason. 

Explanation: An unusual condition 
occurred during a catalog or index 
operation. The condition is de¬ 
scribed in detail. 


END OF ERROR ANALYSIS LISTING. 


System Action: The request is 

ignored. (The return code is 8.) 
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IEH212I REQUIRED VOLUME COULD NOT BE 
MOUNTED- 

Explanation: A device was not 

allocated for the required volume. 

System Action: The request is 

ignored* (The return code is 8.) 


The IEHMOVE Program 


IEH301I OPERATION NOT VALID. 

Explanation: The control statement 
operation is invalid. 

System Action: The MOVE/COPY 

request is ignored. (The return 
code is 8-) 


System Action: The MOVE/COPY 
request is ignored. (The return 
code is 8.) 


IEH319I MEMBER xxx NOT MOVED/COPIED. 

DUPLICATE NAME IN OUTPUT DATA SET. 

Explanation: A member with the 

same name is contained in the 
output partitioned data set. 

System Action: The request is 
ignored. (The return code is 8.) 


IEH320I MEMBER XXX NOT FOUND IN DATA SET 

XXX. 

Explanation: The named member can¬ 
not be located in the partitioned 
data set* 


IEH304I INVALID 

SEQUENCE. 


CONTROL 


STATEMENT 


System Action: The request is 
ignored. (The return code is 8.) 


Explanation: A MOVE/COPY statement 
is incorrectly followed by an 
INCLUDE* EXCLUDE* REPLACE* or SE¬ 
LECT statement. 

System Action: The MOVE/COPY 
request is ignored. (The return 
code is 8.) 


IEH305I ERROR IN OPERAND FIELD. 


IEH321I MEMBER XXX NOT MOVED/COPIED. OUT¬ 
PUT DIRECTORY IS FULL. 

Explanation: The directory of the 
output partitioned data set is 
full. 

System Action: The named member 
was not moved or copied. (The 
return code is 8.) 


Explanation: An error exists in 
the control statement operand 
field. 


IEH322I I/O ERROR ENCOUNTERED IN MEMBER 
xxx OF INPUT DATA SET xxx. 


System 


Action: 


The 


IEH313I 


request is 
code is 8.) 


ignored. 


MOVE/COPY 
(The return 


IEH311I INCOMPLETE REQUEST. 

Explanation: The control statement 
does not contain adequate informa¬ 
tion to perform the MOVE/COPY 
operation. 

System Action: The MOVE/COPY 
request is ignored. (The return 
code is 8.) 


DATA SET XXX HAS INCORRECT FORMAT 
FOR UNLOADED DATA SET. 


Explanation: A permanent error was 
detected while the named member 
was being read. 

System Action: The MOVE/COPY 
request is ignored. (The return 
code is 8.) 


IEH323I I/O ERROR ENCOUNTERED IN MEMBER 
xxx OF OUTPUT DATA SET xxx. 

Explanation: A permanent error was 
detected while the named member 
was being written. 

System Action: The MOVE/COPY 
request is ignored. (The return 
code is 8.) 


Explanation: The request to move 
or copy an unloaded data set is 
ignored because its format is 
incorrect. The records are appar¬ 
ently out of sequence. 


IEH325I INVALID CATLG REQUEST IGNORED. 

Explanation: The specified receiv¬ 
ing volume is not direct-access. 
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IEH326I 


IEH346I 


IEH348I 


IEH349I 


IEH351I 


IEH354I 


System Action: The moved or copied 
data set was not cataloged on this 
volume as requested, (The return 
code is 8.) 


System 


Action: The named data set 
(The return 


was not cataloged, 
code is 8.) 


I/O ERROR ENCOUNTERED IN OUTPUT 
DATA SET xxx. 

Explanation: A permanent error was 
detected while the named data set 
was being written. 

System Action: The request is ter¬ 
minated. The return code is 8. 


CATALOG CANNOT BE LOCATED* OR CON¬ 
TROL VOLUMES ARE CONNECTED TO EACH 
OTHER. 

Explanation: No catalog exists on 
the specified control volume* or 
control volumes are connected 
incorrectly to each other. 

System Action: The request is 
ignored- (The return code is 8.) 


IEH356I DATA SET xxx NOT CATALOGED. 

INVALID DATA SET NAME. 

Explanation: The specified 

set name is inappropriate 
cataloging. 

System Action: The data set 
not cataloged. (The return 
is 8.) 


IEH372I I/O ERROR ENCOUNTERED IN WORK 
SET. 

Explanation: A permanent 

input/output error was detected 
while reading or writing the work 
data set. 

System Action: The request is ter¬ 
minated. (The return code is 12.) 


data 

for 


was 

code 


DATA 


I/O ERROR ENCOUNTERED IN CATALOG. 

Explanation: A permanent error was 
encountered while reading or writ¬ 
ing the catalog. 


IEH373I UNABLE TO MOUNT VOLUME xxx. SOME 
INCLUDE OR REPLACE REQUESTS 
IGNORED. 


Explanation: The program 

mount the named volume. 


cannot 



System Action: The request is ter¬ 
minated. (The return code is 8.) 


UNABLE TO MOUNT VOLUME xxx... 
action- 

Explanation: No device was allo¬ 
cated for the specified volume. 


System Action: The INCLUDE or 
REPLACE requests that refer to the 
specified volume were ignored. 
(The return code is 8.) 


IEH374I DATA SET xxx NOT FOUND ON VOLUME 
xxx. INCLUDE OR REPLACE REQUEST 
IGNORED. 


Sys tern Action: The request is 
ignored. (The return code is 8.) 


Explanation: The named data set 
does not reside on the specified 
volume. 


DATA SET XXX NOT CATALOGED. SPACE 
NOT AVAILABLE IN THE CATALOG. 

Explanation: The catalog is full. 


System Action: The INCLUDE or 
REPLACE statements that refer to 
the specified data set were 
ignored. (The return code is 8.) 


System Action: The named data set 
was not cataloged. (The return 
code is 8.) 


IEH375I DATA SET xxx IS NOT PARTITIONED. 

INCLUDE OR REPLACE REQUEST 
IGNORED. 


* 


* 


DATA SET xxx NOT CATALOGED. INDEX 
STRUCTURE INCONSISTENT. 

Explanation: An invalid index 

structure exists. 


Explanation: The named data set is 
not partitioned. 

System Action: The INCLUDE request 
or the including part of the 
REPLACE request was ignored. (The 
return code is 8.) 
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IEH376I 


RECORD CHARACTERISTICS NOT COMPAT¬ 
IBLE (XXX) . INCLUDE OR REPLACE 
REQUEST IGNORED. 

Explanation: An attribute (xxx) of 
the output data set is not compat¬ 
ible with that of the input data 
set. 

System Action: The INCLUDE request 
or the including part of the 
REPLACE request was ignored. (The 
return code is 8.) 


IEH380I MEMBER xxx NOT FOUND IN DATA SET 
xxx* INCLUDE OR REPLACE REQUEST 
IGNORED. 

Explanation: The named member is 
not contained in the named parti¬ 
tioned data set. 

System Action: The INCLUDE request 
or the including part of the 
REPLACE request is ignored. (The 
return code is 8.) 


IEH383I INVALID DEVICE NAME. 

Explanation: A device name on the 
utility statement is invalid. 

System Action: The request is 
ignored. (The return code is 8.) 


IEH388I SPACE NOT AVAILABLE FOR WORK DATA 
SET. 

Explanation: Space is not availa¬ 
ble for the work data set. The 
MOVE/COPY request was ignored. 


System Action: The MOVE/COPY pro¬ 
gram was terminated. (The return 
code is 12.) 


IEH389I I/O ERROR ENCOUNTERED IN INPUT 
DATA SET xxx. 

Explanation: A permanent error was 
detected while the input data set 
was being read. 

System Action: The request is ter¬ 
minated. (The return code is 12.) 


IEH401I DATA SET xxx NOT MOVED/COPIED _ 

reason. 

Explanation: The named data set 
was not moved or copied, for the 
reason given. 

System Action: The request is 
ignored. (The return code is 8.) 


IEH402I DATA SET xxx UNLOADED _ reason. 

System Action: The data set was 
unloaded for the reason given. 
(The return code is 8.) 


IEH436I DATA SET xxx, VOLUME xxx, NOT 
SCRATCHED DUE TO I/O ERROR. 

System Action: The named data set 
was not scratched after the MOVE 
operation. (The return code is 
8 .) 
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APPENDIX D: DATA SET UTILITY ERROR MESSAGES 


This appendix, message appendixes in other publications, and the publication IBM 
System/360 Operating System: Control Program Messages and Completion Codes are designed 
so that the user can select the messages applicable to his installation and incorporate 
them in a binder. 

Data set utility messages indicating job termination can be interpreted several ways; 

1. If the utility program was invoked, a return code is passed to the calling 
program with the option to terminate. 

2. If the utility program represents one step of a multi-step job, the step is 
terminated. 

3. Otherwise, the job is terminated. 


The IEBCOPY Program 


IEB105I INVALID REBLOCKING REQUEST. 


IEB101I INVALID OPERATION. 

Explanation: The operation field 
of the above statement is invalid. 


System Action: The job is termi¬ 
nated. (The return code is 12.) 


IEB102I INVALID KEYWORD. 

Explanation: An invalid keyword 

appears in the operand of the 
above statement. 

System Action: The job is termi¬ 
nated. (The return code is 12.) 


IEB103I INVALID PARAMETER VALUE. 

Explanation: An invalid parameter 
value appears in the operand of 
the above statement. 

System Action: The job is termi¬ 
nated. (The return code is 12.) 


Explanation: The request for 
reblocking does not satisfy the 
necessary conditions. 

System Action: No reblocking was 
performed. 


IEB108I INCLUSIVE COPY ASSUMED. 

Explanation: The TYPCOPY parameter 
was not specified in the COPY 
statement. 

System Action: The entire data set 
is copied. (The return code is 
8 .) 


IEB109I TOTAL COPY ASSUMED. 

Explanation: No control statements 
appeared; the entire input data 
set is copied. 

System Action: The entire data set 
is copied. (The return code is 
8 . ) 


IEB10 4I MAX NAME VALUE TOO SMALL. 

Explanation: The value in the par¬ 
ameter of the COPY statement is 
less than the total number of 
member names and aliases in the 
MEMBER statement. 

System Action: The job is termi¬ 
nated. (The return code is 12.) 


IEB110I xxx NOT FOUND IN DIRECTORY. 

Explanation: The named member was 
not found in the directory of the 
SYSUTl data set. 

System Action: The specified mem¬ 
ber is not copied. (The return 
code is 8.) 
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IEB118I 


DIRECTORY READ ERROR. 


IEB126I 


INVALID CONTROL STATEMENT. 


IEB119I 


IEB120I 


IEB121I 


IEB122I 


IEB123I 


IEB124I 


Explanation: A permanent error was 
detected while reading the direc¬ 
tory of the SYSUT1 data set. 

System Action: The job is termi¬ 
nated. (The return code is 12.) 

DIRECTORY WRITE ERROR. 

Explanation: A permanent error was 
detected while writing the direc¬ 
tory of the SYSUT2 data set. 

System Action: The job is termi¬ 
nated. (The return code is 12.) 


Explanation: The construction of 
the above control statement is 
invalid. 

System Action: The job is termi¬ 
nated. (The return code is 12.) 


NO MEMBER NAMES FOR PARTIAL COPY. 

Explanation: A selective copy is 
specified and no MEMBER statements 
are included. 

System Action: The job is termi¬ 
nated. (The return code is 12.) 


PERMANENT INPUT ERROR. 

Explanation: A permanent error was 
detected while reading the SYSUT1 
data set. 

System Action: The job is termi¬ 
nated. (The return code is 12.) 


IEB128I DDNAME XXX CANNOT BE OPENED 


Explanation: The named DD state¬ 

ment does not exist. 

System Action: The job is termi¬ 
nated. (The return code is 12) 


PERMANENT OUTPUT ERROR. 

Explanation: A permanent error was 
detected while writing the SYSUT2 
data set. 


User Response: Either correct the 
ddname if it is misspelled in the 
DD statement or the ddlist, or 
insert a new DD statement with 
this name. 


System Action: The job is termi¬ 
nated. (The return code is 12.) 


CONTROL STATEMENT INPUT ERROR. 


The IEBCOMPR Program 


Explanation: A permanent error was 
detected while reading the SYSIN 
data set. 

System Action: The job is termi¬ 
nated. (The return code is 12.) 


OUTPUT DIRECTORY FILLED. 


IEB201I INVALID CONTROL STATEMENT. 

Explanation: The construction of 

the above control statement is 
invalid. 

System Action: The job is termi¬ 
nated. (The return code is 12.) 


Explanation: The directory of the IEB202I INVALID OPERATION. 


SYSUT2 data set does not contain 
sufficient space for all the mem¬ 
ber entries. 

System Action: The job is termi¬ 
nated. (The return code is 12.) 


Explanation: The operation field 
of the above statement is invalid. 

System Action: The job is termi¬ 
nated. (The return code is 12.) 


NO NAMES FOUND IN DIRECTORY. IEB203I INVALID KEYWORD. 


Explanation: The SYSUT1 data set 
does not contain identified mem¬ 
bers. 

System Action: The job is termi¬ 
nated. (The return code is 12.) 


Explanation: The operand field of 
the above statement contains an 
invalid keyword. 

System Action: The job is termi¬ 
nated. (The return code is 12.) 
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IEB204I 


INVALID PARAMETER VALUE. 


IEB217I 


PERMANENT INPUT ERROR. 


IEB205I 


IEB210I 


IEB211I 


IEB212I 


IEB214I 


IEB215I 


Explanation: An invalid parameter 

value appears in the above state- Explanation: A permanent error was 

ment. detected while reading one of the 

input data sets. 

System Action: The job is termi¬ 
nated. (The return code is 12.) 

System Action: The job is termi¬ 
nated. (The return code is 12.) 

USER DATA FIELDS UNEQUAL. 


Explanation: The user data fields 
of the SYSUT1 and SYSUT2 data sets 
are unequal. 

System Action: The fields are 
listed and the comparison contin¬ 
ues. (The return code is 8.) 


TRUE NAMES MISSING FROM BOTH SETS. 


IEB221I RECORDS ARE NOT EQUAL. 

Explanation: Two corresponding 
records do not contain the same 
data. 

System Action: The records are 
listed and the comparison contin¬ 
ues. (The return code is 8.) 


Explanation: All the names in one 

directory must have counterpart IEB222I KEYS ARE NOT EQUAL, 
entries in the other. This condi¬ 
tion was not met. Explanation: Two corresponding 

keys do not contain the same data. 

System Action: The job is termi¬ 
nated. (The return code is 12.) System Action: The records are 

listed and the comparison contin¬ 
ues. (The return code is 8.) 

KEY LENGTHS ARE NOT EQUAL. 


Explanation: The SYSUT1 and SYSUT2 

keys are of different lengths. IEB223I EXTRA RECORD ON SYSUT2. 


System Action: The job is termi¬ 
nated. (The return code is 12.) 


Explanation: The SYSUT2 data set 
contains more records than the 
SYSUT1 data set. 


INVALID RECORD FORMAT. System Action: The records are 

printed. (The return code is 8.) 

Explanation: The record formats 

are not standard. 


System Action: The job is termi- IEB224I EXTRA RECORD ON SYSUT1. 


nated. (The return code is 12.) 


FIXED RECORD LENGTHS UNEQUAL. 

Explanation: SYSUT1 contains 
records of a different length than 
those in SYSUT2. 


Explanation: The SYSUT1 data set 
contains more records than the 
SYSUT2 data set. 

System Action: The extra records 
are printed. (The return code is 
8 .) 


System Action: The job is termi¬ 
nated. (The return code is 12.) 

IEB225I JOB TERMINATED AFTER EXIT. 


RECORD FORMATS DIFFERENT. 

Explanation: The record charac¬ 

teristics of the SYSUT1 and SYSUT2 
data sets differ,. 

System Action; The job is termi¬ 
nated. (The return code is 12,) 


Explanation: The return code from 
an exit routine indicates termina¬ 
tion. 

System Action: The job is termi¬ 
nated. (The return code is 12 or 
16. It is determined by exit 
routine.) 
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IEB227I TEN CONSECUTIVE ERRORS 


IEB306I 


JOB TERMINATED AFTER KEY EXIT. 


Explanation: An error routine is 
not specified and ten successive 
unequal comparison have occurred. 

System Action: If the input data 
sets are sequential, the job is 
terminated. If the input data 
sets are partitioned, processing 
will continue with the next mem¬ 
ber. If the current member is the 
last, the job is terminated. (The 
return code is 12 for sequential 
data sets and 8 for partitioned 
data sets.) 


IEB228I DDNAME xxx CANNOT BE OPENED 


Explanation: The named DD state¬ 

ment does not exist. 

System Action: The job is termi¬ 
nated. (The return code is 12.) 

User Response: Either correct the 
ddname if it is misspelled in the 
DD statement or the ddlist, or 
insert a new DD statement with 
this name. 


Explanation: The return code from 
a KEY exit routine indicates ter¬ 
mination. 

System Action: The job is termi¬ 
nated. (The return code is 12 or 
16, determined by the exit rou¬ 
tine. ) 


IEB307I JOB TERMINATED AFTER DATA EXIT. 

Explanation: The return code from 
a DATA exit routine indicates ter¬ 
mination. 

System Action: The job is termi¬ 
nated. (The return code is 12 or 
16, determined by the exit rou¬ 
tine. ) 


IEB308I PERMANENT INPUT ERROR. 

Explanation: A permanent error was 
detected while reading the SYSUT1 
data set. 

System Action: The job is termi¬ 
nated. (The return code is 12.) 


The IEBGENER Program 


IEB303I INVALID CONTROL STATEMENT. 

Explanation: The construction of 

the above control statement is 
invalid. 

System Action: The job is termi¬ 
nated. (The return code is 12.) 


IEB304I CONTROL STATEMENT INPUT ERROR. 

Explanation: A permanent error was 
detected while reading the SYSIN 
data set. 

System Action: The job is termi¬ 
nated. (The return code is 12.) 


IEB305I JOB TERMINATED AFTER LABEL EXIT. 

Explanation: The return code from 
a label exit routine indicates 
termination. 

System Action: The job is termi¬ 
nated. (The return code is 16.) 


IEB309I PERMANENT OUTPUT ERROR. 

Explanation: A permanent error was 
detected while writing the SYSUT2 
data set. 

System Action: The job is termi¬ 
nated. (The return code is 12.) 


IEB310I DIRECTORY WRITE ERROR. 

Explanation: A permanent error was 
detected while writing the direc¬ 
tory of the SYSUT2 data set. This 
error could result if the SYSUT2 
data set is not partitioned. 

System Action: The job is termi¬ 
nated. (The return code is 12.) 


IEB311I OUTPUT DIRECTORY FILLED. 

Explanation: The directory of the 
SYSUT2 data set does not contain 
sufficient space for all the mem¬ 
ber entries. 

System Action: The job is termi¬ 
nated. (The return code is 12.) 
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IEB312I JOB TERMINATED AFTER ERROR EXIT. 

Explanation; The return code from 
an ERROR exit routine indicated 
termination. 

System Action: The job is termi¬ 
nated. (The return code is 12.) 


IEB404I KEYWORD INVALID OR OMITTED. 

Explanation: A required keyword is 
either incorrectly written or not 
included in the above statement. 

System Action: The job is termi¬ 
nated. (The return code is 12.) 


IEB315I SPACE NOT AVAILABLE. 

Explanation: The required main 

storage space is not available. 

System Action: The job is termi¬ 
nated. (The return code is 12.) 


IEB316I DDNAME xxx CANNOT BE OPENED 


Explanation: The named DD state¬ 

ment does not exist. 

System Action: The job is termi¬ 
nated- (The return code is 12-) 

User Response: Either correct the 
ddname if it is misspelled in the 
DD statement or the ddlist,, or 
insert a new DD statement with 
this name. 


IEB405I PARAMETER INVALID OR OMITTED. 

Explanation: A required parameter 
is either incorrect, inconsistent, 
or not included in the above 
statement. 

System Action: The job is termi¬ 
nated- (The return code is 12.) 


IEB406I JOB TERMINATED AFTER USER EXIT. 

Explanation: The job was terminat¬ 
ed after control was returned from 
an exit routine. 

System Action: The job is termi¬ 
nated- (The return code is 12 or 
16, determined by exit routine.) 


IEB407I JOB TERMINATED DUE TO I/O ERROR. 


Explanation: A permanent error was 
encountered. 


The IEBPTPCH Program 


System Action: The job is termi¬ 
nated. (The return code is 12.) 


IEB401I PRINT/PUNCH STATEMENT NOT FIRST. 

Explanation: A PRINT or PUNCH 
statement is not the first utility 
control statement. 

System Action: The job is termi¬ 
nated. (The return code is 12-) 


IEB408I MEMBER xxx CANNOT BE FOUND. 

Explanation: The specified member 
is not contained in the SYSUT1 
data set. 

System Action: The member was not 
printed/punched. (The return code 
is 8.) 


IEB402I INVALID OPERATION, JOB TERMINATED. 

Explanation: The operation in the 

above utility statement is inval¬ 
id. 

System Action: The job is termi¬ 
nated- (The return code is 12.) 


IEB409I INVALID CONTROL STATEMENT 


Explanation: The construction of 
the above control statement is 
invalid. 


IEB403I MORE THAN TWO TITLE STATEMENTS. 


System Action: The job is termi¬ 
nated. (The return code is 12.) 


Explanation: More than two TITLE 
statements are included. 


IEB410I INCORRECT RECORD STATEMENT 


System Action: The job is termi¬ 
nated. (The return code is 12.) 


Explanation: The above RECORD 
statement is written incorrectly. 
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System Action: The job is termi¬ 
nated. (The return code is 12.) 


IEB505I I/O ERROR ON SYSUT2. 
NATED. 


JOB TERMI- 


IEB411I DDNAME xxx CANNOT BE OPENED 

Explanation: The named DD state¬ 

ment does not exist. 

System Action: The job is termi¬ 
nated. (The return code is 12.) 

User Response: Either correct the 
ddname if it is misspelled in the 
DD statement or the ddlist, or 
insert a new DD statement with 
this name. 


The IEBUPDAT Program 


IEB501I INVALID EXIT NAME. JOB TERMINAT¬ 
ED. 

Explanation: An exit routine name 
in the EXEC statement is invalid. 

System Action: The job is termi¬ 
nated. (The return code is 12.) 


IEB502I EXIT RETURN CODE INDICATES TERMI¬ 
NATION. 

Explanation: The return code from 

an exit routine is 16. 

System Action: The job is termi¬ 
nated. 


IEB503I I/O ERROR ON SYSUTl. JOB TERMI¬ 
NATED. 


Explanation: A permanent error was 
encountered while the SYSUT2 data 
set was being written. 

System Action: The job is termi¬ 
nated. (The return code is 12.) 


IEB509I CURRENT TRANSACTION REJECTED. 

Explanation: The transaction rep¬ 
resented by the printed control 
statement and logical record 
statements is rejected because the 
control statement is written 
incorrectly appears in the wrong 
position with respect to other 
control statements. 

System Action: Processing contin¬ 
ues with the next member of the 
library. (The return code is 4.) 


IEB510I NO RECORDS WITHIN DELETE RANGE. 

Explanation: No records were found 
within the range specified in the 
DELET statement. 

System Action: Processing contin¬ 
ues with the next member of the 
library. (The return code is 4.) 


IEB511I NO RECORDS WITHIN NUMBER RANGE. 

Explanation: No records were found 
within the range specified in the 
NUMBR statement. 

System Action: Processing contin¬ 
ues with the next member of the 
library. (The return code is 4.) 


Explanation: A permanent error was 
encountered while the SYSUTl data 
set was being read. 

System Action: The job is termi¬ 
nated. (The return code is 12.) 


IEB504I I/O ERROR ON SYSIN. JOB TERMINAT¬ 
ED. 


IEB512I DIRECTORY WRITE ERROR. 

Explanation: A permanent error was 
detected while writing the direc¬ 
tory of the SYSUT2 data set. This 
error could result if the SYSUT2 
data set is not partitioned. 

System Action: The job is termi¬ 
nated. (The return code is 16.) 


Explanation: A permanent error was 
encountered while the SYSIN data 
set was being read. 

System Action: The job is termi¬ 
nated. (The return code is 12.) 


IEB513I OUTPUT DIRECTORY FILLED. 

Explanation: The directory of the 
SYSUT2 data set does not contain 
sufficient space for all the mem¬ 
ber entries. 
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System Action: The job is termi¬ 
nated, (The return code is 12.) 


IEB514I MEMBER HAS NO RECORDS. 

Explanation: The member identified 
in the printed header statement 
contains no records. 

System Action: Processing contin¬ 
ues with the next member of the 
library. (The return code is 4.) 


IEB515I IMPROPER INVOCATION PARAMETER. 

Explanation: Either the program or 
the EXEC statement calling IEBUP- 
DAT has incorrectly passed parame¬ 
ters. 

System Action: The request is ter¬ 
minated. (The return code is 12.) 


IEB516I MEMBER NAME SEQUENCE ERROR. 

Explanation: Member names, speci¬ 
fied on header statements, are not 
in binary collating sequence. 

System Action: Processing contin¬ 
ues with the next member of the 
library. (The return code is 4.) 


IEB517I DDNAME xxx CANNOT BE OPENED 


Explanation: The named DD state¬ 

ment does not exists 

System Action: The job is termi¬ 
nated. (The return code is 12.) 

User Response: Either correct the 
ddname if it is misspelled in the 
DD statement or the ddlist, or 
insert a ,£iew DD statement with 
this name. 
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APPENDIX E: INDEPENDENT UTILITY MESSAGES 


This appendix,, message appendixes in other publications, and the publication IBM 
System/360 Operating System; Control Program Messages and Completion Codes are designed 
so that the user can select the messages applicable to his installation and incorporate 
them in a binder. 

Independent utility programs write error messages and diagnostic messages. Error 
messages describe error conditions associated with the utility programs. Diagnostic 
messages describe and locate faulty conditions associated with the hardware. 


Error Messages 


Error messages are listed in alphameric 
order with explanations and, when applica¬ 
ble, a recommended response. 


IBC106A THE VOLID IN CONTROL STATEMENT 
DOES NOT AGREE WITH ID IN VOL 
LABEL WHICH FOLLOWS,. VOLID=xxx. 

Explanation: The VOLID parameter 
in the utility control statement 
did not match the volume serial 
number found on the receiving vol¬ 
ume (xxx) . 


IBC101W INVALID CARD CODE. JOB TERMINAT¬ 
ED. 


Explanation: An invalid card code 
appears in the above card. 


IBC102A CONTROL STATEMENT ERROR. JOB TER¬ 
MINATED. 

Explanation: A utility control 
statement contains an incorrect 
keyword, parameter, or name field. 


Response: Correct statement or 
mount correct volume and restart 
program. 


IBC107W TRACK ZERO BAD. JOB TERMINATED. 

Explanation: The device cannot be 
initialized as a systems residence 
volume due to a defective surface 
on cylinder 00, track 00. 


IBC108A HA or R0 FIELD BAD. JOB TERMINAT¬ 
ED. 


IBC103A STATEMENT SEQUENCE ERROR. JOB 
TERMINATED. 

Explanation: The utility state¬ 
ments are not in the proper 
sequence, or unnecessary utility 
statements are present. 


IBC104W SVC INTERRUPT. JOB TERMINATED. 

Explanation: An SVC was initiated 
without a response having been 
defined. 


Explanation: The device cannot be 
initialized due to a bad surface 
area in the home address or track 
descriptor record areas. 


IBC109I TRACK CHK INDICATES TRACK IS GOOD. 

Explanation: The track in question 
is good and no alternate was 
assigned. 


IBC110I BAD TRACK CCCChhhh. 


IBC105A DEFINE INPUT DEVICE. 

Response: Enter the following mes¬ 
sage from console typewriter: 
INPUT=dddd cuu, where dddd is the 
device type and cuu is the channel 
and unit address of the input 
device. 


Explanation: A defective track was 
found at the specified location 
(cccc is the cylinder number, hhhh 
is the head number). 


IBC111I ALTERNATE cccchhhh. 

Explanation: An alternate track at 
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IBC112W 


IBC151W 


IBC152W 


IBC153A 


IBC154A 


IBC155A 


the specified location is assigned IBC156A READY TAPE cuu. DEPRESS INTERRUPT 


to replace the defective track 
(cccc is the cylinder number, hhhh 
is the head number). 


KEY. 

Explanation: The tape drive on 

channel c, unit uu is not ready. 


ALT TRACKS DEPLETED. JOB TERMI¬ 
NATED. 

Explanation: The number of alter¬ 
nate tracks assigned has exceeded 
the maximum number for this 
device.. 


Response: Correct the faulty con¬ 
dition and depress the console 
interrupt key. 


IBC157A READY DISK CUU. DEPRESS INTERRUPT 
KEY. 


MACHINE CHECK. JOB TERMINATED. 


Explanation: The disk drive on 

channel c, unit uu is not ready. 


Explanation: A machine malfunction 
has caused a machine interrupt 
resulting in termination of the 
job. 


Response: Correct the faulty con¬ 
dition and depress the console 
interrupt key. 


PROGRAM INTERRUPT. JOB TERMINAT¬ 
ED. 

Explanation: A program interrupt 
has occurred resulting in termina¬ 
tion of the job. 


TYPEWRITER FAILED TO READ LAST 
MESSAGE. DEPRESS INTERRUPT KEY. 

Explanation: The console typewrit¬ 
er failed to read the input mes¬ 
sage. 

Response: Depress the console 
interrupt key and attempt to enter 
the input message again. 


READY READER CUU. DEPRESS INTER¬ 
RUPT KEY. 

Explanation: The reader has a card 
jam, a transport jam, or is out of 
cards. 

Response: Correct the faulty con¬ 
dition and depress the console 
interrupt key to continue the pro¬ 
gram. 


IBC158A WRONG TAPE ON cuu. MOUNT PROPER 
TAPE. INTERRUPT. 

Explanation: The tape on the spec¬ 
ified device does not pertain to 
this job. 

Response: Mount the correct tape 
and depress the interrupt key. 


IBC159A READER CHECK. CORRECT ERROR. DE¬ 
PRESS INTERRUPT KEY. 

Explanation: A reader check has 
occurred. 

Response: Correct the faulty con¬ 

dition and clear the reader check. 
Continue the program by depressing 
the console interrupt key. 


IBC160A PRINT CHECK, CORRECT ERROR. DE¬ 
PRESS INTERRUPT KEY. 

Explanation: A print check has 

occurred. 

Response: Correct the faulty con¬ 
dition and clear the print check. 
Depress the console interrupt key 
to continue the program. 


READY PRINTER CUU. DEPRESS INTER¬ 
RUPT KEY. IBC161A END OF TAPE. MOUNT TAPE ON cuu. 

DEPRESS INTERRUPT KEY. 


Explanation: The printer is not 
ready due to a forms check, an 
open interlock, or a depressed 
stop key. 

Response: Correct the faulty con¬ 
dition and depress the console 
interrupt key to continue the pro¬ 
gram. 


Explanation: End of present tape 
reel. 

Response: Mount another tape vol¬ 
ume on the active tape device, 
i-e.„ the TODEV device for DUMP 
operations or the FROMDEV device 
for RESTORE operations. 
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IBC162A MOUNT ANOTHER PACK ON UNIT cuu. 
DEPRESS INTERRUPT KEY. 

Explanation: End of the present 
disk pack. 

Response: Mount another disk pack 

on the active disk drive, i.e., 
the TODEV device for DUMP opera¬ 
tions or the FROMDEV device for 
RESTORE operations. 


Diagnostic Messages 

Diagnostic messages appear in the fol¬ 
lowing format: 

number (16-byte text)cuuxxssssyyyy 


IBC206W OVERRUN. 


Explanation: An overrun check has 
occurred on the specified channel. 


IBC207W FLAGGED TRACK. 

Explanation: A track condition 
check has occurred on the speci¬ 
fied device. 


IBC208W DATA CONV. CHECK. 

Explanation: A data converter 
check has occurred on the speci¬ 
fied device. 


where c is the channel of the device in 
error, uu is the unit, xx is the command 
code, ssss are the status bytes from the 
channel status word, and yyyy are the sense 
bytes. 


IBC209W END OF CYLINDER. 

Explanation: An unusual end of 
cylinder condition has occurred on 
the specified device. 


The following message texts are listed 
in alphameric order. All of the messages 
except IBC202A describe conditions that 
cause termination of the job. 


IBC201W COMMAND REJECT. 


IBC210W INVALID ADDRESS. 


Explanation: An invalid address 
has been issued to the specified 
device. 


Explanation: The specified channel 
has rejected an incorrect channel 
command word (CCW) list. 


IBC211W NOT AVAILABLE. 


Explanation: The specified device 
is not attached to the system. 


IBC202A INTERV. REQUIRED. 

Explanation: The specified device 

is not ready. 

Response: The specified device 

requires operator intervention to 
make it ready. 


IBC212W READ DATA CHECK. 

Explanation: A permanent read data 
check has been detected on the 
specified tape unit. 


IBC213W COUNT FIELD CHECK. 


IBC203W BUS. OUT CHECK. 

Explanation: A bus out check has 
occurred on the specified channel- 


Explanation: A data check has 
occurred in the count field of the 
specified direct-access device. 


IBC204W EQUIPMENT CHECK. 

Explanation: An equipment failure 
has occurred. 


IBC214W TRACK OVERRUN. 

Explanation: A track overrun con¬ 
dition has occurred. 


IBC205W DATA CHECK. 

Explanation: A solid data check 
has occurred on the specified 
device- 


IBC215W FILE PROTECTED. 

Explanation: The specified device 

is file protected. 
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IBC216W 


DASD-END OF FILE 


IBC226W 


UNIT EXCEPTION 


IBC217W 


IBC218W 


IBC219W 


IBC220W 


IBC221W 


IBC222W 


IBC223W 


IBC224W 


IBC225W 


Explanation: An unusual end of 
file has occurred on the specified 
direct-access storage device. 


Explanation: A unit exception has 
occurred on the specified unit. 


NO RECORD FOUND. 

Explanation: A no record found IBC227W INCORRECT LENGTH, 

condition has occurred on the 

specified direct-access device. Explanation: A wrong length record 

condition has occurred on the 
specified unit. 

INVALID ERROR. 

Explanation: An invalid error IBC228W CHAINING CHECK, 

return has occurred. 

Explanation: A chaining check has 

occurred on the specified channel. 

WRONG ERROR. 


Explanation: The error return is IBC229W COMMAND SEQ. ERR. 
valid but is not associated with 

the specified device. Explanation: An invalid sequence 

of channel command words (CCWs) 
was issued. 

CHAN. CTRL ERROR. 


Explanation: A channel control IBC230W SEEK CHECK ERROR. 

check has occurred on the speci¬ 
fied channel. Explanation: An invalid SEEK 

address was issued, or a unit 
malfunction caused a SEEK check . 

INTERFACE ERROR. 


Explanation: An interface control IBC231W WRITE DATA CHECK. 

check has occurred on the speci¬ 
fied channel. Explanation: A permanent write 

data check has occurred on the 
specified tape unit. 

CHAN. DATA CHECK. 


Explanation: A channel data check IBC232W TAPE — LOAD POINT, 

has occurred on the specified 

channel. Explanation: A tape at load point 

condition has occurred on the 
specified tape unit,. 

DASD OVERFLOW. 


Explanation: An overflow incom¬ 
plete condition has occurred on 
the specified direct-access 
device* 


IBC233W NOISE RECORD. 

Explanation: A noise record was 

found on the specified tape unit. 


PROGRAM CHECK. 


IBC234W MISSING ADR-MARK. 


Explanation: A program check has 
occurred due to an incorrect chan¬ 
nel command word (CCW). 


Explanation: A missing address 
marker has occurred on the speci¬ 
fied device. 


PROTECTION CHECK. 


IBC249W I/O ERROR, JOB TERMINATED. 

Explanation: This message follows 
all messages that describe 
input/output error conditions. 
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